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Special Notices 
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Chapter 1. Introduction 


This book describes the Operating System/2 (OS/2) Version 1.2 language binding for IBM Macro 
Assembler/2 (MASM). 

It provides language-dependent information about the functions described in the OS/2 Version 1.2 
Presentation Manager Programming Reference. 

The information in this book, together with the functional descriptions in the Presentation Manager 
Programming Reference , enable the user to generate call statements in MASM. 

The following information is provided: 

• The syntax for each data type and structure 

• The parameter list for each call. 


Header Files 

All functions require an “include” for the system header file OS2.INC: 
include 0S2.INC 

Also, most functions require a “define" to select an appropriate (conditional) section of the header 
file, and hence, the required entry point. Where this is necessary, it is shown at the head of the func- 
tion definition in the form: 

INCLjiame equ 1 

Programming Note: These “defines” must precede the “include OS2.INC.” 

Two equates occur in the header files for each constant that represents a 32-bit quantity. These are 
“xxxxJ-H” which is the high-order word of the constant, and “xxxx_LO” which is the low-order word, 
(where “xxxx” is the name of the constant given in the Programming Reference). 


Dynamic Linking 

The processor’s protect-mode call architecture gives various advantages over the static-module 
structure of DOS. In particular, these are: 

• Application programs need only load the most commonly used segments when they are started. 
Exception-processing routines do not need to be loaded as they can be called (and loaded auto- 
matically) as necessary. 

• Dynamic-link package updates can be transparent to their clients. 

The actual programming steps required to use the dynamic link feature are as follows: 

1. The programmer codes a call to a subroutine that is to be dynamically linked and declares it 
“EXTERN name:FAR." 

2. The compiler generates a standard external reference. 

3. When the object module is linked, the linker is provided with the names of libraries containing 
dynamic link definition records. These records provide correspondence between the called 
entry point and the module file containing the routine being called. 
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IBM Operating System/2 Function Calls 

IBM Operating System/2 applications must use the dynamic link mechanism (FAR CALL) to get to all 
services. 


IBM Operating System/2 Function Call Rules 

Rules for the IBM Operating System/2 interface are shown below: 


Rule 1: 
Remarks 


Rule 2: 

Remarks 


Rule 3: 

Remarks 

Rule 4: 
Remarks 
Rule 5: 
Remarks 

Rule 6: 
Remarks 


All parameters are passed on the stack (SS:SP). 

Passing parameters on the stack is consistent across a broad base of languages on 
the 80286/80386 family of processors. The minimum recommended available stack 
space is 2 KB. 

All interfaces pass a return code back to the caller in AX if the returned value is a 
WORD, or in DX:AX if the returned value is a DWORD. 

The use of register AX as a call return code is also consistent across many languages. 
For calls prefixed by DOS, KBD, MOU, and VIO (see Control Program Programming 
Reference) all other user registers except the FLAGS register are preserved. The 
contents of the FLAGS register are undefined. The state of the direction flag in the 
FLAGS register is preserved, or if the direction flag is clear when an API is called, it is 
clear when the API returns. 

All addresses of output parameters are of the form: 
selector: offset. 

Fully-qualified addresses are available across all memory models as a method for 
returning values to a requestor. This allows one function entry point to serve all lan- 
guages and memory models. 

Each function is accessed by a FAR CALL. 

This is a requirement for the calls to be dynamic link entries. 

All calls remove the parameters from the stack. 

Parameter lists are fixed length on a function basis. Variable-length parameter lists 
are not supported. 

All call names must be uppercase when linked. 

If a compiler or assembler generates case-sensitive (uppercase and lowercase) 
external references, ail calls or call definitions must be in uppercase characters. 


IBM Operating System/2 Call Format and Characteristics 

The call descriptions follow a pseudo assembly language format. The interfaces are shown to be 
descriptive rather than to be an example of a coding sequence. The conventions described here are 
used throughout. 

Call Format 

Since all parameters are pushed onto the stack, there are several pseudo operations to describe 
these operations: 

• PUSH - push an item onto the stack. 

This can be used to push various size items onto the stack. 

• PUSH@ - push the address of an item onto the stack. 

All addresses in these interfaces are composed of a 32-bit value: a 16-bit selector and a 16-bit 
offset. This address can point to any of the data item types. 

• CALL - call a function. 

All function calls are accessed via FAR CALLS. This is a requirement when using the Dynamic 
Link mechanism. 
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Programming Note: Note that the format of the function calls is illustrative only. For example, there 
is no actual ‘PUSH®’ instruction in IBM Macro Assembler/2, and ‘PUSH DWORD' implies that 
two words must be pushed, the high-order word first. 


Standard Data Types Used in this Document 

Below is a list of the standard data types used in this document to make up a parameter list: 

Type Description 

WORD 2 bytes. 

This type of operand can be passed by value (pushed onto the stack) or by reference 
(the address of the operand is pushed onto the stack). 

DWORD 4 bytes. 

This type of operand can be passed by value (pushed onto the stack as two sequential 
16-bit values) or by reference (the address of the operand is pushed onto the stack). 

ASCIIZ Null (0) terminated character string. 

This type of operand can only be accessed by reference. 

Other Any other structure. 

This type of operand can only be accessed by reference. 


Mapping Metalanguage Data Types to MASM Data Types 

Some data types shown in Chapter 2 of this book do not occur in MASM, but belong to the 
metalanguage data types described in Chapter 2 of the Presentation Manager Programming Refer- 
ence. They are included to provide a mapping to the corresponding MASM data types, and can be 
identified as those that contain the phrase “(Maps via...).” 

This treatment is not needed for every metalanguage data type, as many of them have the same 
name as the corresponding MASM data type. 


Addressing Elements in Arrays 

Constants defining array elements are given values that are zero-based in MASM; that is, the num- 
bering of the array elements starts at zero, not one. 

For example, In the DevQueryCaps function described in Chapter 3 of the Presentation Manager Pro- 
gramming Reference , the sixth element of the Array parameter is CAPSJHEIGHT, which is equated 
to 5. 

Count parameters related to such arrays always mean the actual number of elements available. 
Therefore, again using the DevQueryCaps function as an example, if all elements up to and including 
CAPSJHEIGHT are provided for, Count could be set to (CAPSJHEIGHT -M). 

In functions for which the starting array element can be specified, this is always zero-based, and the 
MASM element number constants can be used directly. For example, to start with the CAPSJHEIGHT 
element, the Start parameter can be set to CAPSJHEIGHT. 
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Chapter 2. Data Types 


ACCEL 

ACCELTABLE 

ARCPARAM 

ARCPARAMS 

AREABUNDLE 


ATOM 

BANDRECT 


Accelerator structure. 


ACCEL struc 



acc_fs 

dw ? 

;0ptions 

acc_key 

dw ? 

;Key 

acc_cmd 

dw ? 

; Command code 

ACCEL ends 




Accelerator-table structure. 

ACCELTABLE struc 

acct_cAccel dw ? ; Number of accelerator entries 

acct_codepage dw ? ;Code page for accelerator entries 

acct_aaccel dw (size ACCEL) /2 * ACCT_CACCEL dup (?) 

; Accelerator entries 

ACCELTABLE ends 


Arc-parameters structure. 
(Maps via ARCPARAMS) 

Arc-parameters structure. 


ARCPARAMS 

struc 



arcpj P 

dd 

? 

;P coefficient 

arcp_l Q 

dd 

? 

;Q coefficient 

arcpJR 

dd 

? 

;R coefficient 

arcpj S 

dd 

? 

;S coefficient 


ARCPARAMS ends 

Area-attributes bundle structure. 
AREABUNDLE struc 


pbndj Color 

dd 

? 

;Area foreground color 

pbndj BackCol or 

dd 

? 

;Area background color 

pbnd_usMixMode 

dw 

? 

;Area foreground-mix mode 

pbndjisBackMixMode 

dw 

? 

;Area background-mix mode 

pbndjisSet 

dw 

? 

•.Pattern set 

pbnd_us Symbol 

dw 

? 

; Pattern symbol 

pbndjptl Ref Point 

dw 

(size 

P0INTL)/2 dup (?) 

; Pattern reference point 


AREABUNDLE ends 


Atom identity. 

(Scalar type: Maps to word) 

Rectangle structure, used for the coordinates of an output band (see 
DevEscape). 


An empty rectangle is one for which xleft is greater than xright, or ybottom 
is greater than ytop. 


BANDRECT struc 
lx Left dd ? 

lyBottom dd ? 

lxRight dd ? 

lyTop dd ? 

BANDRECT ends 


;x coordinate of left edge of rectangle 
;y coordinate of bottom edge of rectangle 
;x coordinate of right edge of rectangle 
;y coordinate of top edge of rectangle 
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BITMAPINFO 


Bit-map information structure. 


Each bit plane logically contains (bltmapwidth*bitmaphelght*bitcoimt) 
bits, although the actual length can be greater because of padding. 
BITMAPINFO struc 


bmi_cbFix 

dd 

? 

; Length of fixed portion of structure 

bmi_cx 

dw 

? 

;Bit-map width in pels 

bmi_cy 

dw 

? 

; Bit-map height in pels 

btni_cPlane$ 

dw 

? 

; Number of bit planes 

bmi_cBitCount 

dw 

? 

; Number of bits per pel within a plane 

bmi_argbColor 

dw (size RGB)/2 dup (?) ;Array of RGB values 


BITMAPINFO ends 

BITMAPINFOHEADER Bit-map information header structure. 

Each bit plane logically contains (bitmapwidth*bitmapheight*bItcount) 
bits, although the actual length can be greater because of padding. 
BITMAPINFOHEADER struc 


bmp_cbFix 

dd 

? 

; Length of structure 

bmp_cx 

dw 

? 

; Bit-map width in pels 

bmp_cy 

dw 

? 

; Bit-map height in pels 

bmp_cPlanes 

dw 

? 

; Number of bit planes 

bmp_cB it Count 

dw 

? 

;Number of bits per pel within a plane 


BITMAPINFOHEADER ends 

Defines eight independent BOOL values. 

(Maps via UCHAR) 

Defines 16 independent BOOL values. 

(Maps via USHORT) 

Defines 32 independent BOOL values. 

(Maps via ULONG) 

Boolean. 

The BOOL data type is defined such that a nonzero value indicates TRUE, 
and a zero value indicates FALSE. 

The constants TRUE and FALSE have been defined as 1 and 0 respec- 
tively. The constant TRUE should never be used in an equality comparison 
with a BOOL as this may result in incorrect results. 

When an application needs to pass a TRUE value on a function call, or as a 
return value from a window procedure, it is recommended that it passes 
the value TRUE, which is 1, and not a nonzero value. 

(Scalar type: Maps to word) 

BTNCDATA Button-control-data structure. 

BTNCDATA struc 

btncd_cb dw ? ; Length of control data in bytes 

btncdjfsCheckState dw ? ; Check state of button 

btncd_fsHili teState dw ? ; Highlighting state of button 

BTNCDATA ends 

BUFFER Buffer. 

(Maps via PBYTE) 


BIT8 

BIT16 

BIT32 

BOOL 
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BUNDLE 


BYTE 

CATCHBUF 

CHAR 

CHARBUNDLE 


CLASSINFO 

COUNT2 

COUNT2B 

COUNT2CH 

COUNT4 

COUNT4B 

CPtD 

CREATEPARAMS 


Bundle data area. It is overlaid by one of these attribute bundle 
structures: 

AREABUNDLE 

CHARBUNDLE 

IMAGEBUNDLE 

UNEBUNDLE 

MARKERBUNDLE. 

(Maps via PBUNDLE) 

Byte. 

(Scalar type: Maps to byte) 

Saved execution environment buffer. 

CATCHBUF struc 

ctchbf_reserved dd 4 dup (?) ;Save area 
CATCHBUF ends 

Single-byte character. 

(Scalar type: Maps to byte) 

Character-attributes bundle structure. 

CHARBUNDLE struc 


cbndj Color 

dd ? 

Character foreground color 

cbndj BackColor 

dd ? 

; Character background color 

cbnd_usMixMode 

dw ? 

Character foreground-mix mode 

cbnd_usBackMi xMode 

dw ? 

; Character background-mix mode 

cbndjjsSet 

dw ? 

;Character set 

cbnd_us Precis ion 

dw ? 

Character precision 

cbnd_sizfxCell 

dw (size SIZEF) /2 dup (?) Character cell 

cbnd_ptl Angle 

size 

dw (size P0INTL)/2 dup (?) Character angle 

cbnd_ptl Shear 

dw (size 

POINTL) /2 dup (?) Character shear 

cbnd_usDi recti on 

dw ? 

Character direction 

CHARBUNDLE ends 

Class-information structure. 


CLASSINFO struc 

clsi_flClassStyle 

dd ? 

;C1 ass-style flags 

cl si jjfnWindowProc 

dd ? 

; Window procedure 

clsijrbWindowData 

dw ? 

; Number of additional window words 


CLASSINFO ends 

Count in the range 0 through 65 535. 

(Maps via USHORT) 

Count of bytes, in the range 0 through 65 535. 

(Maps via USHORT) 

Count of characters, In the range 0 through 65 535. 
(Maps via USHORT) 

Count in the range 0 through 4 294 967 295. 

(Maps via ULONG) 

Count of bytes, in the range 0 through 4 294 967 295. 
(Maps via ULONG) 

Code-page identity. 

(Maps via USHORT) 

Create parameters structure. 

(Maps via STORAGE) 
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CREATESTRUCT 


CTLDATA 


CURSORINFO 


DDEINIT 


DDESTRUCT 


DEVOPENDATA 


Create-window data structure. 
CREATESTRUCT struc 


crstjpPresParams 

dd 

? 

crst_pCtlData 

dd 

? 

crstjd 

dw 

? 

crstJiwndlnsertBehind 

dd 

? 

crstJiwndOwner 

dd 

? 

crst_cy 

dw 

? 

crst_cx 

dw 

? 

erst j 

dw 

? 

erstje 

dw 

7 

crst_fl Style 

dd 

? 

crst_p$zText 

dd 

7 

crst_pszClass 

dd 

7 

crst_hwnd Parent 

dd 

1 


CREATESTRUCT ends 


presentation parameters 
;Control data 
; Window identifier 
; Window behind which the window 
is to be placed 
; Window owner 
; Window height 
; Window width 
;y coordinate of origin 
;x coordinate of origin 
; Window style 
; Window text 

Registered window class name 
parent window handle 


Class-specific control data, beginning with a value conforming to a 
COUNT2B data type, which specifies the overall length of the data. 


The following are cases of this data type: 


BTNCDATA 

ENTRYFDATA 

FRAMECDATA 

SBCDATA 

MLECDATA 


Button control data. 

Entry field control data. 

Frame control data. 

Scroll bar control data. 

Multi-line entry field control data. 


(Maps via PVOID) 


Cursor-information structure. 


CURSORINFO struc 
csrijiwnd dd ? 

csri_x dw ? 

csri _y dw ? 

csri_cx dw ? 

csri_cy dw ? 

csrijfs dw ? 

csrijrclClip dw 
CURSORINFO ends 


;Window handle 
;x coordinate 
;y coordinate 
•.Cursor width 
; Cursor height 
; Options 

size RECTL)/2 dup (?) 


; Cursor box 


Dynamic-data-exchange initiation structure. 
DDEINIT struc 


ddei_cb 

dw 

? 

; Length of structure 

ddei_pszAppName 

dd 

? 

Application name 

ddei_pszTopic 

dd 

? 

;Topic 

DDEINIT ends 

Dynamic-data-exchange control structure. 

DDESTRUCT struc 

dde_cbData 

dd 

? 

;Total length 

dde_fsStatus 

dw 

7 

; Status 

dde_usFormat 

dw 

? 

;Data format 

dde_offszItemName 

dw 

7 

; Offset to item 

dde_offabData 

dw 

7 

;0ffset to beginning of data 


DDESTRUCT ends 


Open-device data area. The format of this area is the same as a 
DEVOPENSTRUC structure. 

(Maps via PDEVOPENDATA) 
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DEVOPENSTRUC 


DLGTEMPLATE 


DLGTITEM 


DRIVDATA 


Open-device data structure. 

The same structure is applicable to both DevOpenDC and SpIQmOpen 
calls. 

DEVOPENSTRUC struc 


dopj)szLogAddress 


dd 

? ; Logical address 

dop_pszDri verName 


dd 

? ; Driver name 

dop_pdri v 


dd 

? ;Driver data 

dopjjszDataType 


dd 

? ;Data type 

dop_pszComment 


dd 

? ; Comment 

dop_pszQueueProcName 


dd 

? ;Queue-processor name 

dop_pszQueueProcParam$ 

dd 

? ;Queue-processor parameters 

dop_pszSpoo1 erParams 


dd 

? ; Spooler parameters 

dop_pszNetworkParams 


dd 

? ; Network parameters 

DEVOPENSTRUC ends 

Dialog-template structure. 



DLGTEMPLATE struc 

d1gt_cbTemplate 

dw 

? 

; Length of template 

dl gt _type 

dw 

? 

;Template format type 

dlgt_codepage 

dw 

? 

;Code page 

dlgt_offadlgti 

dw 

? 

;0ffset to dialog items 

dlgt_fsTemplateStatus dw 

? 

;Template status 

dlgtJItemFocus 

dw 

? 

; Index of item to receive focus 
initially 

dl gt_coff PresParams 

dw 

? 

;Count of presentation-parameter 
offsets 

dlgt_adlgti 

dw (size DLGTITEM) /2 dup (?) ;Start of 
dialog items 

DLGTEMPLATE ends 

Dialog-item structure. 

DLGTITEM struc 

dlgti_fsItemStatus 

dw 

? 

; Status 

dlgti_cChildren 

dw 

? 

;Count of children to this dialog 
item 

dlgti_cchClassName 

dw 

? 

; Length of class name 

dlgti_offClassName 

dw 

? 

; Offset to class name 

dlgti_cchText 

dw 

? 

; Length of text 

dlgti_offText 

dw 

? 

;0ffset to text 

dl gti_f 1 Style 

dd 

? 

; Dialog item window style 

dlgtijc 

dw 

? 

;x coordinate of origin of 
dialog-item window 

dlgti _y 

dw 

? 

;y coordinate of origin of 
dialog-item window 

dlgti_cx 

dw 

? 

;Dialog-item window width 

dlgti^cy 

dw 

? 

;Dialog-item window height 

dlgti_id 

dw 

? 

identity 

dlgti_off PresParams 

dw 

? 

Reserved 

dlgti_offCtlData 

dw 

? 

; Offset to control data 

DLGTITEM ends 

Driver-data structure. 

DRIVDATA struc 

dri v_cb 

dd 

? 

; Length 

drivj Version 

dd 

? 

;Version 

dri v_szDevi ceName 

db 32 dup 

(?) ; Device name 

dri v_abGeneral Data 

db 

? 

; General data 


DRIVDATA ends 
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ENTRYFDATA 

ERRKNFO 


ERRORID 

FATTRS 


FFDESCS 

FIXED 


Entry field control data structure. 
ENTRYFDATA struc 


efd_cb 

dw 

? 

; Length of control data in bytes 

efd_cchEdit Limit 

dw 

? 

;Edit limit 

efd_ichMinSel 

dw 

? 

; Mini mum selection 

efd 1 J chMaxSel 
ENTRYFDATA ends 

dw 

? 

;Maximum selection 


Error-information structure. 
ERRINFO struc 


erri_cbFixedErr!nfo dw 

? 

; Length of fixed data to this 
structure 

erri JdError 

dd 

? 

; Error identity 

erri_cDetail Level 

dw 

? 

; Number of levels of detail 

erri_offaoffszMsg 

dw 

? 

; Offset to the array of message 
offsets 

erri_of fBi naryData 
ERRINFO ends 

dw 

? 

;0ffset to the binary data 


Error identity. 

(Scalar type: Maps to dword) 

Font-attributes structure. 
FATTRS struc 


fat_usRecordLength 

dw 

? 

; Length of record 

fat_fsSelection 

dw 

? 

Selection indicators 

f at J Match 

dd 

? 

;Matched-font identity 

fat_szFacename 

db FACESIZE dup (?) ;Typeface name 

fatJdRegistry 

dw 

? 

; Registry identifier 

fat_usCodePage 

dw 

? 

;Code page 

fat_l MaxBasel i neExt 

dd 

? 

;Maximum base-line extension 

fatJAveCharWidth 

dd 

? 

; Average character width 

fat_fsType 

dw 

? 

;Type indicators 

fat_fsFontUse 

dw 

? 

; Font-use indicators 


FATTRS ends 
Font-file descriptor. 

(Scalar type: Maps to byte * FACESIZE * 2) 

Signed-integer fraction (16:16). This can be treated as a LONG where the 
value has been multiplied by 65 536. 

(Scalar type: Maps to dword) 
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FONTMETRICS 


Font-metrics structure. 

FONTMETRICS struc 

fm_sz Family name db FACES I ZE dup (?) ; Family name 

fm_szFacename db FACESIZE dup (?) ;Facename 


fmJdRegistry 

dw 

? 

fmjJsCodePage 

dw 

? 

fmJEmHeight 

dd 

? 

fmJXHeight 

dd 

? 

fmJMaxAscender 

dd 

? 

fmJMaxDescender 

dd 

? 

fmj LowerCaseAscent 

dd 

? 

fmj LowerCaseDescent 

dd 

? 

fmj Internal Leading 

dd 

? 

fmj External Leading 

dd 

? 

fmJAveCharWidth 

dd 

? 

fmJMaxCharlnc 

dd 

? 

fmj Emlnc 

dd 

? 

fmJMaxBaselineExt 

dd 

? 

fm_sCharSl ope 

dw 

? 

fm_sInlineDir 

dw 

? 

fm_sCharRot 

dw 

? 

fmjisWeightClass 

dw 

? 

fmjjsWidthClass 

dw 

? 

fm_sXDeviceRes 

dw 

? 

fm_$YDevi ceRes 

dw 

? 

fm_sFirstChar 

dw 

? 

fm_sLastChar 

dw 

? 

fm_sDefaultChar 

dw 

? 

fm_sBreakChar 

dw 

? 

fm_sNomi nal Poi ntSi ze 

dw 

? 

fm_sMinimumPointSize 

dw 

? 

fm_sMaximumPointSize 

dw 

? 

fm_fsType 

dw 

? 

fm_fsDefn 

dw 

? 

fmjfsSelection 

dw 

? 

fm_fsCapabilities 

dw 

? 

fmj Subscri ptXSi ze 

dd 

? 

fmJSubscriptYSize 

dd 

? 

fmj Subscri ptXOf f set 

dd 

? 

fmj Subscri ptYOf f set 

dd 

? 

fmj Superscri ptXSi ze 

dd 

? 

fmj Superscri ptYSi ze 

dd 

? 

fmj Superscri ptXOf f set 

dd 

? 

fmj Superscri ptYOf f set 

dd 

? 

fmj UnderscoreSize 

dd 

? 

fmj UnderscorePosi ti on 

dd 

? 

fmj StrikeoutSize 

dd 

? 

fmj Stri keoutPos i ti on 

dd 

? 

fm_sKerningPairs 

dw 

? 

fm_sFamilyClass 

dw 

? 

fmj Match 

dd 

? 


FONTMETRICS ends 


Registry identifier 
Code page 
Em height 
x height 

Maximum ascender 
Maximum descender 
Lowercase ascent 
Lowercase descent 
Internal leading 
External leading 
Average character width 
Maximum character increment 
Em increment 
Maximum baseline extent 
Character slope 
Inline direction 
Character rotation 
Weight class 
Width class 
x device resolution 
y device resolution 
First character 
Last character 
Default character 
Break character 
Nominal point size 
Minimum point size 
Maximum point size 
Type indicators 
Definition indicators 
Selection indicators 
Capabilities 
Subscript x size 
Subscript y size 
Subscript x offset 
Subscript y offset 
Superscript x size 
Superscript y size 
Superscript x offset 
Superscript y offset 
Underscore size 
Underscore position 
Strikeout size 
Strikeout position 
Kerning pairs 
Family class 
Matched font identity 
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FRAMECDATA Frame-control-data structure. 

FRAMECDATA struc 


fcdata_cb 

dw 

? 

; Length 

fcdata_f 1 CreateFl ags 

dd 

? 

; Frame-creation flags 

fcdata_hmodResources 

dw 

? 

; Identifier of required resource 

fcdataj dResources 

dw 

? 

; Resource identifier 


FRAMECDATA ends 

GRADIENT Direction-vector structure. 

(Maps via GRADIENTL) 

GRADIENTL Direction-vector structure. 

GRADIENTL struc 

gradljc dd ? ;x component of direction 

gradl _y dd ? ;y component of direction 

GRADIENTL ends 


HAB 

Anchor-block handle. 

(Maps via HANDLE) 

HACCEL 

Accelerator-table handle. 

(Maps via HANDLE) 

HANDLE 

The handle of a resource. 


(Maps via LHANDLE) 

HAPP 

Handle of an application started by the WinlnstStartApp function. 
(Maps via HANDLE) 

HATOMTBL 

Atom-table handle. 

(Maps via HANDLE) 

HBITMAP 

Bit-map handle. 

(Maps via HANDLE) 

HCINFO 

Hardcopy-capabilities structure. 


HCINFO struc 


hci_szFormname 

db 32 dup (?) ;Form name 

hci_cx 

dd 

? 

;Width (left-to-right) in millimeters 

hci_cy 

dd 

? 

; Height (top-to-bottom) in millimeters 

hci_xLeftClip 

dd 

? 

;Left clip limit in millimeters 

hci ^yBottomClip 

dd 

? 

;Bottom clip limit in millimeters 

hci_xRightClip 

dd 

? 

;Right clip limit in millimeters 

hci _yropci ip 

dd 

? 

;Top clip limit in millimeters 

hci_xPels 

dd 

? 

; Number of pels between left and right 
clip limits 

hci^yPels 

dd 

? 

;Number of pels between bottom and top 
clip limits 

hci_fl Attributes 
HCINFO ends 

dd 

? 

; Attributes of the form identifier 


HDC 

Device-context handle. 

(Maps via HANDLE) 

HENUM 

Window-enumeration handle. 
(Maps via HANDLE) 

HHEAP 

Heap handle. 

(Maps via HANDLE) 

HINI 

Initialization-file handle. 
(Maps via HANDLE) 

HLIB 

Library handle. 

(Maps via HANDLE) 

HMF 

Metafile handle. 

(Maps via HANDLE) 
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HMODULE 

Module handle. 

(Scalar type: Maps to word) 

HMQ 

Message-queue handle. 

(Maps via HANDLE) 

HPOINTER 

Handle of a pointer. 

(Maps via HANDLE) 

HPROC 

Processor handle. 

(Maps via HANDLE) 

HPROGARRAY 

Array of program handles. 

HPROGARRAY struc 

hpga_ahprog dd ? ; Program handle array 

HPROGARRAY ends 

HPROGRAM 

Program handle. 

(Maps via HANDLE) 

HPS 

Presentation-space handle. 

(Maps via HANDLE) 

HRGN 

Region handle. 

(Maps via HANDLE) 

HSEM 

Semaphore handle. 


(Scalar type: Maps to dword) 

HSPL 

Spooler handle. 

(Maps via HANDLE) 

HSWITCH 

Switch-list-entry handle. 

(Maps via HANDLE) 

HVPS 

VIO presentation-space handle. 


(Scalar type: Maps to word) 

HWND 

Window handle. 

(Maps via HANDLE) 

IDENTITY 

Identity value. Up to 65 536 different identities are available. 

(Maps via USHORT) 

IDENTITY4 

Identity value. Up to 4 294 967 296 different identities are available. 
(Maps via ULONG) 

IMAGEBUNDLE 

Image-attributes bundle structure. 


IMAGEBUNDLE struc 


i bind _1 Col or 

dd 

? 

; Image foreground color 

i bind J BackCol or 

dd 

? 

; Image background color 

ibmd_usMixMode 

dw 

? 

; Image foreground-mix mode 

i bmdjJsBackMi xMode 

dw 

? 

; Image background-mix mode 


IMAGEBUNDLE ends 

INDEX2 Index value, in the range 0 through 65 535. 

(Maps via USHORT) 

IPT Insertion point for multi-line entry field. 

(Maps via LONG) 

KERNINGPAIRS Kerning-pair records structure. 

KERNINGPAIRS struc 

krnpr_sFirstChar dw ? ; First character of pair 

krnpr_sSecondChar dw ? ; Second character of pair 

krnpr_sKerningAmount dw ? ; Amount of kerning for this pair 

KERNINGPAIRS ends 

LENGTH2 Length value, In the range 0 through 65 535. 

(Maps via USHORT) 
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LENGTH4 

LHANDLE 

LINEBUNDLE 


LONG 


MARGSTRUCT 

MARKERBUNDLE 


MATRIX 


Length value, in the range 0 through 4 294 967 295. 
(Maps via ULONG) 

The handle of a resource. 

(Scalar type: Maps to dword) 


Line-attributes bundle structure. 
LINEBUNDLE struc 


1 bnd _1 Col or 

dd 

? 

;Line foreground color 

lbndj Reserved 

dd 

? 

; Reserved 

1 bnd_usMi xMode 

dw 

? 

; Li ne foreground-mix mode 

lbnd_usReserved 

dw 

? 

; Reserved 

lbnd_fxWidth 

dd 

? 

;Line width 

lbndj GeomWidth 

dd 

? 

; Geometric line width 

1 bnd jjsType 

dw 

? 

;Line type 

lbnd_usEnd 

dw 

? 

;Line end 

lbnd_usJoin 
LINEBUNDLE ends 

dw 

? 

;Line join 


Signed integer in the range —2 147 483 648 through 2 147 483 647. 

Note: Where this data type represents a graphic coordinate in world or 
model space, its value is restricted to —134 217 728 through 
134 217 727. A graphic coordinate in device or screen coordinates 
is restricted to —32 768 through 32 767. Its value may be further 
restricted by any transforms currently in force, including the posi- 
tioning of the origin of the window on the screen. In particular, 
coordinates in world or model space must not generate coordinate 
values after transformation (that is in device or screen space) 
outside the range —32 768 through 32 767. 

(Scalar type: Maps to dword) 

Multi-line entry field margin information. 


MARGSTRUCT struc 



m_fs Flags 

dw 

? 

m_u$MouMsg 

dw 

? 

mj ptNear 

dd 

? 

MARGSTRUCT ends 




Marker-attributes bundle structure. 
MARKERBUNDLE struc 


mbndj Color 

dd 

? 

;Marker foreground color 

mbndJBackColor 

dd 

? 

;Marker background color 

mbnd_usMi xMode 

dw 

? 

; Marker foreground-mix mode 

mbnd_usBackMi xMode 

dw 

? 

; Marker background-mix mode 

mbndjJsSet 

dw 

? 

;Marker set 

mbndjjs Symbol 

dw 

? 

; Marker symbol 

mbnd_$izfxCell 
MARKERBUNDLE ends 

dw 

(size SIZEF)/2 dup (?) ;Marker cell 


Matrix-elements structure. 
(Maps via MATRIXLF) 
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MATRIXLF 


MENUITEM 


MLECTLDATA 


MLESE ARCH DATA 


Matrix-elements structure. 


MATRIXLF struc 





matl f_f xMll 

dd 

? 


; First element of first row 

matl f_f xM12 

dd 

? 


;Second element of first row 

matlf JM13 

dd 

? 


; Third element of first row 

matlf_fxM21 

dd 

? 


; First element of second row 

mat1f_fxM22 

dd 

? 


; Second element of second row 

matlf_lM23 

dd 

? 


;Third element of second row 

matlfJM31 

dd 

? 


; First element of third row 

matlfj M32 

dd 

? 


;Second element of third row 

matlfj M33 

dd 

? 


;Third element of third row 

MATRIXLF ends 





Menu Item. 





MENUITEM struc 





mi _i Position 


dw 

? 

position 

mi_afStyle 


dw 

? 

; Style 

mi_af Attribute 

dw 

? 

; Attribute 

mi_id 


dw 

? 

; Identity 

mi_hvmd$ubMenu 

dd 

? 

; Submenu 

mi Ji I tern 


dd 

? 

;Item 


MENUITEM ends 

Multi-line entry-field control data structure. 


MLECTLDATA struc 
efd_cbCtlData 

dw 

? 

; Length of control data in bytes 

efd_afIEFormat 

dw 

? 

; Import/export format 

efd_cchText 

dd 

? 

;Text limit 

efdJptAnchor 

dd 

? 

Selection anchor point 

efd_i ptCursor 

dd 

? 

Selection cursor point 

efd_cxFormat 

dd 

? 

; Formatting rectangle width in 

efd_cyFormat 

dd 

7 

pixels 

; Formatting rectangle height in 

efd_afFormatFl ags 

dd 

? 

pixels 

; Format flags 


MLECTLDATA ends 

Search structure for multi-line entry field. 
MLE.SEARCHDATA struc 


se_sStructSize 

dw 

? 

;Size of MLE SEARCHDA TA 

structure 

se_sFi ndStri ngLength 

dw 

? 

; Length of findstring string 

se_pszFindString 

dd 

? 

;String to search for 

se_iptStart 

dd 

? 

; Point at which to start 
search, or point where 
string was found 

seJptStop 

dd 

? 

; Point at which to stop search 

se^sFoundStri ngLength 

dw 

? 

; Length of string found at 
start 

se_sChangeStri ngLength 

dw 

? 

; Length of replacement string 

se_p$zChangeString 

MLE SEARCHDATA ends 

dd 

? 

; Replacement string 
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MPARAM 4-byte message-dependent parameter structure. 

Certain elements of information, placed into the parameters of a message, 

have data types that do not consume the whole of the 4 bytes of this data 

type. The rules governing these cases are: 

BOOL The value is contained in the low word and the high word is 
zero. 

SHORT The value is contained in the low word and its sign is 
extended into the high word. 

USHORT The value is contained in the low word and the high word is 
zero. 

NULL The entire 4 bytes are zero. 

(Scalar type: Maps to dword) 

MQINFO Message-queue information structure. 


MQINFO struc 




mqi_cb 

dw 

? 

; Length of structure 

mqi_pid 

dw 

? 

; Process identity 

mqijtid 

dw 

? 

;Thread identity 

mqi_cmsgs 

dw 

? 

;Message count 

mqi_pReserved 
MQINFO ends 

dd 

? 

; Reserved 


M RESULT 4-byte message-dependent reply parameter structure. 

Certain elements of information, placed into the parameters of a message, 
have data types that do not consume the whole of the 4 bytes of this data 
type. The rules governing these cases are: 

BOOL The value is contained in the low word and the high word is 
zero. 

SHORT The value is contained in the low word and its sign is 
extended into the high word. 

USHORT The value is contained in the low word and the high word is 
zero. 

NULL The entire 4 bytes are zero. 

(Scalar type: Maps to dword) 

MT Menu template. 

(Maps via PVOID) 

MTI Menu template item. 

MTI struc 

mti_af Style dw ? ; Style 

mti_afAttr$ dw ? ; Attributes 

mtijdltem dw ? ;Item identity 

mti_c db 2 dup (?) ;Item data 

MTI ends 

NPBYTE Near pointer to a byte string. 

(Scalar type: Maps to word) 

OFFSET2B Offset value in bytes, in the range 0 through 65 535. 

(Maps via USHORT) 

OVERFLOW Overflow error structure for multi-line entry field. 

OVERFLOW struc 

ofljilErrlnd dd ? ;0ne or more EFR_* flags 

oflJBytesOver dd ? ;Number of bytes over the limit 

oflj)ixHorzOver dd ? ;Number of pixels over the horizontal 

limit 

oflj)ixVertOver dd ? ;Number of pixels over the vertical 

1 imit 

OVERFLOW ends 
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OWNERITEM 


PARAM 

PBYTE 

PCH 

PDEVOPENDAT A 

PFN 

PFNWP 

PIBSTRUCT 


Owner item. 
OWNERITEM struc 


oi_hwnd 

dd 

? 

; Window handle 

oijips 

dd 

? 

; Presentation-space handle 

oi_fsState 

dw 

? 

; State 

oi_fsAttribute 

dw 

? 

; Attribute 

oi_fsState01d 

dw 

? 

;01d state 

oi_fsAttribute01d 

dw 

? 

;01 d attribute 

oijrclltem 

dw (size RECTL)/2 dup (?) ;Item rectangle 

oijdltem 

dw 

? 

;Item identity 

oijiltem 

OWNERITEM ends 

dd 

? 

;Item 


Presentation parameter attribute definition. 

PARAM struc 

paramjd dd ? ; Attribute type identity 

param_cb dd ? ;Byte count of the attrvalue parameter 

param_ab db ? attribute value 

PARAM ends 


Pointer to a data area. 

(Scalar type: Maps to dword) 

Pointer to a character string. 
(Scalar type: Maps to dword) 


Open device-data array. 

This data type points to data whose format is described by the 
DEVOPENSTRUC data type. 

(Scalar type: Maps to dword - address of a DEVOPENDATA) 
Pointer to procedure. 

(Scalar type: Maps to dword) 

Pointer to a window procedure. 


(Scalar type: Maps to dword) 


Program-information-block structure. 


PIBSTRUCT struc 
pib_progt 

pib_szTitle 

pib_szIconFileName 

pib_szExecutable 

pib_szStartupDir 

pib_xywinlnitia1 

pib_resl 

pib_res2 

pib^cchEnvi ronmentVars 
pi b_pchEnvi ronmentVars 
pi b_cchProgramParameter 
pi b_pchProgramParameter 
PIBSTRUCT ends 


dw (size PR0GTYPE)/2 dup (?) ;Program 
type and visibility 

db (MAXNAMEL+1) dup (?) ;Program title 
(null terminated) 

db (MAX PATH L+l) dup (?) ; Program icon 

filename (null terminated) 
db (MAXPATHL+1) dup (?) Executable 
file name (null terminated) 
db (MAXPATHL+1) dup (?) ; Start-up 

directory (null terminated) 
dw (size XYWINSIZE)/2 dup (?) jlnitial 
window position and size 
dw ? Reserved; must be zero 

dw (size LHANDLEJ/2 dup (?) Reserved; 
must be zero 

dw ? Environment string length 

dd ? Environment string 

dw ? ; Parameter string length 

dd ? ; Parameter string 


Chapter 2. Data Types 2-13 



PID 

PIX 

POINT 

POINTERINFO 


POINTL 

POINTS 

PQMOPENDATA 

PRESDATA 

PRESPARAMS 

PRFPROFILE 

PROC 

PROGCATEGORY 


Process identity. 

(Scalar type: Maps to word) 

Pel count for multi-line entry field. 
(Maps via LONG) 

Point structure. 

(Maps via POINTL) 

Pointer-information structure. 


POINTERINFO struc 




ptri_f Pointer 

dw 

? 

;Bit-map size indicator 

ptri_xHotspot 

dw 

? 

;x coordinate of action point 

ptri jrHotspot 

dw 

? 

;y coordinate of action point 

ptri_hbmPointer 

dd 

? 

; Bit-map handle of pointer 

ptriJibmColor 
POINTERINFO ends 

dd 

? 

; Bit-map handle of color bit map 


Point structure (long integer). 

POINTL struc 

ptl_x dd ? ;x coordinate 

ptl _y dd ? ;y coordinate 

POINTL ends 

Point structure (short integer). 

POINTS struc 

pts_x dw ? ;x coordinate 

pts^y dw ? ;y coordinate 

POINTS ends 

Open queue-manager data array. 

This data type points to data whose format is described by the 
DEVOPENSTRUC data type. 

(Scalar type: Maps to dword - address of a QMOPENDATA) 

Class-specific control presentation data, conforming to a PRESPARAM 
data type. 

(Maps via PVOID) 

Presentation parameter data. 

PRESPARAMS struc 

pres_cb dd ? ;Byte count of the param parameter 

pres_aparam dw (size PARAM)/2 dup (?) ;Array of attribute 
parameters 

PRESPARAMS ends 

Profile structure. 

PRFPROFILE struc 


prfprojrchUserName 

dd 

? 

; Length of user profile name 

prfpro_pszUserName 

dd 

? 

;User profile name 

prfpro_cchSysName 

dd 

? 

; Length of system profile name 

prfpro_pszSysName 

dd 

? 

; System profile name 


PRFPROFILE ends 

Procedure identifier. 

(Maps via PFN) 

Program category. 

(Scalar type: Maps to byte) 
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PROGDETAILS 


PROGRAMENTRY 

PROGTITLE 

PROGTYPE 

PROPERTY2 

PROPERTY4 

PSZ 

PVOID 

QMOPENDATA 


Program details structure. 


PROGDETAILS struc 




progde_Length 

dd 

? 

; Length of structure 

progde_progt 

dw (size 

PROGTYPE) /2 dup (?) program 




type 

progde_padl 

dw 3 

dup 

(?) Reserved 

progde_pszTitle 

dd 

? 

;Title 

progdejjszExecutabl e 

dd 

? 

; Executable file name 

progde_pszParameters 

dd 

? 

; Parameter string 

progdejjszStartupDi r 

dd 

? 

; Start-up directory 

progde_pszIcon 

dd 

? 

; Icon-file name 

progdej)szEnvi ronment 

dd 

? 

•.Environment string. (List of 
null -terminated strings, 
ending with an extra null) 

progde_swpInitial 

dw (size 

SWP)/2 dup (?) jlnitial window 




position and size 

progde_pad2 

dw 5 dup 

(?) Reserved 

PROGDETAILS ends 





Program-entry structure. 

PROGRAMENTRY struc 

proge_hprog dd ? ; Program handle 

proge_progt dw (size PR0GTYPE)/2 dup (?) ;Program type 

proge_szTitle db (MAXNAMEL+1) dup (?) ;Program title 

(null terminated) 

PROGRAMENTRY ends 

Program-title structure. 

PROGTITLE struc 

progti_hprog dd ? ; Program handle 

progti_progt dw (size PR0GTYPE)/2 dup (?) ;Program type 
progti_padl dw 3 dup (?) Reserved 

progti_p$zTitle dd ? ;Program title 

PROGTITLE ends 

Program-type structure. 

PROGTYPE struc 

progt_progc db ? ; Program category 

progtjfbVisible db ? Visibility attribute 
PROGTYPE ends 

Property value. Up to 65 536 different properties are available. 

(Maps via USHORT) 

Property value. Up to 4 294 967 296 different properties are available. 
(Maps via LONG) 

Pointer to a null-terminated string. 

(Scalar type: Maps to dword - address of an ASCIIZ) 

Pointer to a data type of undefined format. 

(Scalar type: Maps to dword) 

Open queue-manager data area. The format of this area is the same as a 
DEVOPENSTRUC structure. 

(Maps via PQMOPENDATA) 
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QMSG 


RECT 

RECTL 


RESID 

RGB 

RGNRECT 


ROF 

ROL 


Message structure. 



QMSG struc 
qmsg_hwnd 

dd 

? 

; Window handle 

qmsgjnsg 

dw 

? 

;Message identity 

qmsgjnpl 

dd 

? 

; Parameter 1 

qmsgjnp2 

dd 

? 

; Parameter 2 

qmsg_time 

dd 

? 

;Message time 

qmsg_ptl 

dw (size 

POINTL) /2 dup (?) ;Pointer position when 

QMSG ends 



message was generated 


Rectangle structure. 


Unless otherwise stated, points on the right-hand or top boundaries of the 
rectangle are not considered to be included in the rectangle; points on the 
left-hand or bottom boundaries (that are not also on the right-hand or top 
boundaries) are included in the rectangle. 

(Maps via RECTL) 


Rectangle structure. 
RECTL struc 


rcl_xLeft 

dd 

? 

rcl jrBottom 

dd 

? 

rcl_xRight 

dd 

? 

rcl jrTop 

dd 

? 


RECTL ends 


;x coordinate of left-hand edge of 
rectangle 

;y coordinate of bottom edge of rectangle 
;x coordinate of right-hand edge of 
rectangle 

;y coordinate of top edge of rectangle 


Resource identity. 
(Maps via HMODULE) 


RGB color value. 

RGB struc 
rgb_bBl ue db ? 

rgb_bGreen db ? 

rgb_bRed db ? 

RGB ends 


;Blue component of the color definition 
; Green component of the color definition 
;Red component of the color definition 


Region-rectangle structure. 
RGNRECT struc 
rgnrc_i restart dw ? 

rgnrc_crc dw ? 

rgnrc_crc Returned dw ? 

rgnrc_usDi recti on dw ? 

RGNRECT ends 


; Rectangle number from which to start 
enumerating 

; Number of rectangles that can be 
returned 

; Number of rectangles returned 

;Di recti on in which the returned 
rectangles are to be ordered 


Number representation, equivalent to FIXED. 
(Maps via FIXED) 

Number representation, equivalent to LONG . 
(Maps via LONG) 


2-16 PM Macro Assembler/2 Bindings Reference 



SBCDATA 


SEGOFF 

SHORT 

SIZEF 


SIZEL 


SIZEROF 

SIZEROL 

SMHSTRUCT 


STORAGE 

STR 

STRCOND 


Scroll-bar control data structure. 

SBCDATA struc 
sbcd_cb dw ? 

sbcd_sHilite dw ? 

sbcd_posFirst dw ? 

sbcdjposLast dw ? 

sbcd_posThumb dw ? 

sbcd_cVisible dw ? 

sbcd_cTotal dw ? 

SBCDATA ends 

2-byte segment offset in bytes. 

(Maps via NPBYTE) 


; Length of control data in bytes 
;Hi ghl i ghti ng code 

; First bound of the scroll -bar range 
;Last bound of the scroll -bar range 
;Slider position 
; Number of data items visible 
; Number of data items available 


Signed integer in the range —32 768 through 32 767. 
(Scalar type: Maps to word) 


Size structure. 
SIZEF struc 
sizfx_cx 
sizfx_cy 
SIZEF ends 

Size structure. 
SIZEL struc 
sizl_cx 
sizl_cy 
SIZEL ends 


dd ? ; Width 
dd ? ; Height 


dd ? ; Wi dth 
dd ? ; Height 


Size structure. 
(Maps via SIZEF) 


Size structure. 
(Maps via SIZEL) 


Send message hook structure. 


SMHSTRUCT struc 
smhs_mp2 dd ? 

smhsjnpl dd ? 

smhsjnsg dw ? 

smhs_hwnd dd ? 

SMHSTRUCT ends 


; Parameter 2 
; Parameter 1 
;Message identity 
; Window handle 


Storage that may contain different data types. 

(Maps via PVOID) 

String with an explicit length count. 

(Maps via PCH) 

String with a length count that is determined by special values of its asso- 
ciated length parameter. 

For example, positive values of the associated length parameter provide 
the length count explicitly, whereas the value —1 implies that the string is 
null-terminated and hence its length is implicit. 

Where this data type occurs, the associated length parameter specifies the 
meanings of its values in determining the length count of the string. 

(Maps via PCH) 
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STRL 

STRLLIST 

STR8 

STR16 

STR32 

STR64 

SWBLOCK 

SWCNTRL 


SWENTRY 

SWP 


SZ 

TID 


Null-terminated string, that is, its length can be implied by the system. 
(Maps via SZ) 

A list of null-terminated strings (that is, a series of concatenated strings 
each of which has a STRL data type) terminated by an additional null. 
(Maps via SZ) 

String of 8 characters. 

(Scalar type: Maps to db * 8 dup (?)) 

String of characters, with an implicit length, in a 16-byte field. 

(Scalar type: Maps to db * 16 dup (?)) 

String of characters, with an implicit length, in a 32-byte field. 

(Scalar type: Maps to db * 32 dup (?)) 

String of characters, with an implicit length, in a 64-byte field. 

(Scalar type: Maps to db * 64 dup (?)) 

Switch list block structure. 

SWBLOCK struc 

swbl k_cswentry dw ? ; Count of switch list entries 

swbl k_aswentry dw (size SWENTRY)/2 * SWBLK_CSWENTRY dup (?) 

; Switch list entries 

SWBLOCK ends 

Switch-list control block structure. 

SWCNTRL struc 


swctl_hwnd 

dd ? 

;Window handle 

swctl Jiwndlcon 

dd ? 

;Window-handle icon 

swctl_hprog 

dd ? 

; Program handle 

$wctl_idProcess 

dw ? 

; Process identity 

swctl_idSession 

dw ? 

; Session identity 

swctl jjchVisibility 

db ? 

Visibility 

swctljfbJump 

db ? 

;Jump indicator 

swctl _szSwti tie 

db (MAXNAMEL+1) dup (?) ;Switch-list contrc 



block title (null terminated) 

swctl_fReserved 

db ? 

; Reserved 

SWCNTRL ends 



Switch list entry structure. 


SWENTRY struc 



swent_hswi tch dd ? 

; Switch list entry handle 

swent_swctl dw (size SWCNTRL) /2 dup (?) ;$witch list control 


block structure 

SWENTRY ends 



Set Window Position structure. 


SWP struc 



swp^fs 

dw ? 

;0ptions 

swp_cy 

dw ? 

; Window height 

swp_cx 

dw ? 

; Window width 

swp_y 

dw ? 

;y coordinate of origin 

swp_x 

dw ? 

;x coordinate of origin 

s wp_hwnd I ns ert Behi nd 

dd ? 

; Window behind which this window 



is placed 

swpjiwnd 

dd ? 

; Window handle 


SWP ends 

Null-terminated string (also known as a zero-terminated string). (ASCIIZ) 
(Maps via PSZ) 

Thread identity. 

(Scalar type: Maps to word) 


2-18 PM Macro Assembler/2 Bindings Reference 



TIME 

TRACKINFO 


UCHAR 

ULONG 

USERBUTTON 

USHORT 

VOID 

WIDTH4 

WNDPARAMS 


WNDPROC 


Time interval in milliseconds. 
(Maps via LONG) 

Tracking-information structure. 


TRACKINFO struc 



ti_cxBorder 

dw 

? ; Border width 

ti_cy Border 

dw 

? ; Border height 

ti_cxGrid 

dw 

? ;Grid width 

ti_cyGrid 

dw 

? ;Grid height 

ti _cxKeyboard 

dw 

? Character cell width movement for 

arrow key 

ti_cyKeyboard 

dw 

? Character cell height movement for 

arrow key 

ti_rcl Track 

dw 

(size RECTL)/2 dup (?) ;Starting tracking 
rectangl e 

ti_rcl Boundary 

dw 

(size RECTL)/2 dup (?) ;Boundary 
rectangle 

ti _ptlMinTrackSize 

dw 

(size POINTL) /2 dup (?) jMinimum 
tracking size 

ti j)tl MaxTrackSi ze 

dw 

(size P0INTL)/2 dup (?) ;Maximum 
tracking size 

ti_fs 

TRACKINFO ends 

dw 

? ;Tracking options 


Unsigned integer in the range 0 through 255. 

(Scalar type: Maps to byte) 

Unsigned integer in the range 0 through 4 294 967 295. 
(Scalar type: Maps to dword) 

User-button data structure. 

USERBUTTON struc 


ubtn_hwnd 

dd 

? 

; Window handle 

ubtn_hps 

dd 

? 

; Presentation-space handle 

ubtn_f$State 

dw 

? 

;New state of user button 

ubtn_fsState01 d 

dw 

? 

;01d state of user button 


USERBUTTON ends 

Unsigned integer in the range 0 through 65 535. 

(Scalar type: Maps to word) 

A data area of undefined format. 

(Scalar type: Maps to other) 

Width in the range -2 147 483 648 through 2 147 483 647. 
(Maps via LONG) 

Window parameters. 

WNDPARAMS struc 


wprm^fsStatus 

dw 

? 

; Window parameter selection 

wprm_cchText 

dw 

? 

; Length of window text 

wprmj)szText 

dd 

? 

; Window text 

wprm_cbPresParams 

dw 

? 

; Length of presentation parameters 

wprm_pPresParams 

dd 

? 

; Presentation parameters 

wprm_cbCtlData 

dw 

? 

; Length of window class specific data 

wprm_pCtlData 

dd 

? 

; Window class specific data 


WNDPARAMS ends 

Window-procedure identifier. 
(Maps via PFNWP) 
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WPOINT Window point structure (integer). 

WPOINT struc 

wpt_x dw ? ;x coordinate 

wpt_dummyl dw ? ; Reserved 

wptjf dw ? ;y coordinate 

wpt_dummy2 dw ? Reserved 

WPOINT ends 

WRECT Window rectangle structure (integer). 

WRECT struc 

wrc_xLeft dw ? ;x coordinate of left-hand edge of 

rectangle 

wrc_dummyl dw ? ; Reserved 

wrcjrtJottom dw ? ;y coordinate of bottom edge of rectangle 

wrc_dummy2 dw ? ; Reserved 

wrc_xRight dw ? ;x coordinate of right-hand edge of 

rectangl e 

wrc_dummy3 dw ? Reserved 

wrc^yTop dw ? ;y coordinate of top edge of rectangle 

wrc_dummy4 dw ? Reserved 

WRECT ends 

XYWINSIZE Window position and size structure. 

XYWINSIZE struc 


xywi n_x 

dw 

? 

;x coordinate of window 

origin 

xywi n_y 

dw 

? 

;y coordinate of window 

origin 

xywi n_cx 

dw 

? 

;Window width 


xywi n_cy 

dw 

? 

;Window height 


xywin_fsWindow 

dw 

? 

;Window options 



XYWINSIZE ends 
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Chapter 3. Device Function Calls 


DevCIoseDC 

EXTRN DevCIoseDC: FAR 

INCLJ)EV equ 1 ;0r use INCL_PM. Also in COMMON section 

PUSH DWORD hdc ; Device-context handle 
CALL DevCIoseDC 

Returns DWORD hmf ; Error indicator/metafile handle (for a metafile device context) 


DevEscape 

EXTRN DevEscape: FAR 

INCL_DEV equ 1 ;0r use INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 
PUSH® DWORD 
PUSH® OTHER 
CALL DevEscape 


hdc ; Dev ice-context handle 

ICode ; Escape code 

1 InCount ; Input data count 

blnData ;The input data required for this escape 
lOutCount ; Output data count 
bOutData ; Output data 


Returns DWORD 1 Result ; Impl emented/error indicator 


DevOpenDC 

EXTRN DevOpenDC: FAR 

INCL_DEV equ 1 ;Or use INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD IType ;Type of device context 

PUSH® ASCI IZ szToken ; Device-information token 

PUSH DWORD 1 Count ; Number of items 

PUSH® OTHER dopData ; Open-device-context data area 

PUSH DWORD hdcComp ; Compatible-device-context handle 

CALL DevOpenDC 

Returns DWORD hdc ; Device-context handle 


DevPostDeviceModes 

EXTRN DevPostDeviceModes: FAR 
INCL_DEV equ 1 ;0r use INCL.PM 


PUSH 

PUSH® 

PUSH® 

PUSH® 

PUSH® 

PUSH 


DWORD 

OTHER 

ASCIIZ 

ASCIIZ 

ASCIIZ 

DWORD 


hab 

drivDriverData 

szDriverName 

szDeviceName 
szName 
fl Opt ions 


; Anchor-block handle 
; Driver data 

;This is a string containing the name of the presentation 
device driver 
;Device-type name 
; Device name 
;Dialog options 


CALL DevPostDeviceModes 


Returns DWORD IDriverCount ;Size/error indicator 
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DevQueryCaps 

EXTRN DevQueryCaps: FAR 

INCLJ)EV equ 1 ;0r use INCLJ>M. Also in COMMON section 

PUSH DWORD hdc ; Device-context handle 

PUSH DWORD 1 Start ; First item of information 

PUSH DWORD 1 Count ; Count of items of information 

PUSH? OTHER alArray ;Device capabilities 

CALL DevQueryCaps 

Returns WORD f Success ;Success indicator 


DevQueryDeviceNames 

EXTRN DevQueryDeviceNames: FAR 
INCL_DEV equ 1 ;0r use INCL_PM 


PUSH 

DWORD 

hab 

; Anchor-block handle 

PUSH? 

ASCIIZ 

szDriverName 

; Fully qualified name of the file containing the presentation 




driver 

PUSH? 

DWORD 

ldn 

;Maximum number of device names and descriptions that can be 




returned 

PUSH? 

OTHER 

aDeviceName 

; Device-name array 

PUSH? 

OTHER 

aDeviceDesc 

;Device description array 

PUSH? 

DWORD 

ldt 

;Maximum number of data types that can be returned 

PUSH? 

OTHER 

aDataType 

;Data type array 

CALL DevQueryDeviceNames 


Returns WORD 

fSuccess 

;Success indicator 

DevQueryHardcopyCaps 


EXTRN DevQueryHardcopyCaps: FAR 

INCL_DEV equ 

1 ;0r use INCL_PM 

PUSH 

DWORD 

hdc 

; Device-context handle 

PUSH 

DWORD 

lStartForm 

;Start-forms code 

PUSH 

DWORD 

1 Forms 

; Number of forms to query 

PUSH? 

OTHER 

hciHclnfo 

; Hardcopy capabilities information 


CALL DevQueryHardcopyCaps 

Returns DWORD 1 FormsReturned ;Details of forms 
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Chapter 4. Graphics Presentation Interface Function 
Calls 


GpiAssociate 

EXTRN GpiAssociate: FAR 

INCL_GPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hdc ; Device-context handle 

CALL GpiAssociate 

Returns WORD f Success ; Success indicator 


GpiBeginArea 

EXTRN GpiBeginArea: FAR 

INCLJ3PI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD fl Opt ions ;Area options 
CALL GpiBeginArea 

Returns WORD f Success ; Success indicator 


GpiBeginElement 

EXTRN GpiBeginElement: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lType ;Type to be associated with element 
PUSH@ ASCIIZ szDesc ;Description 

CALL GpiBeginElement 

Returns WORD f Success ; Success indicator 


GpiBeginPath 

EXTRN GpiBeginPath: FAR 

INCL_GPIPATHS equ 1 ;0r use INCLJjPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IPath ;Path identifier 

CALL GpiBeginPath 

Returns WORD f Success ; Success indicator 


GpiBitBIt 

EXTRN GpiBitBIt: FAR 

INCL_GPIBITMAPS equ 1 ;0r use INCLJaPI or INCL_PM. Also in COMMON section 

PUSH DWORD hpsTarget ;Target presentation-space handle 

PUSH DWORD hpsSource ; Source presentation-space handle 

PUSH DWORD 1 Count ; Point count 

PUSH@ OTHER aptl Points ; Point array 

PUSH DWORD IRop ;Mixing function required 

PUSH DWORD fl Opt ions ; Options 

CALL GpiBitBIt 

Returns DWORD IHits ; Correlation/error indicator 
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GpiBox 

EXTRN GpiBox: FAR 

INCL.GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Control ; Out line and fill control 

PUSH® OTHER ptl Point ; Corner point 

PUSH DWORD lHRound ; Corner- rounding control 

PUSH DWORD lVRound ;Corner- rounding control 

CALL GpiBox 

Returns DWORD lHits ;Correlati on/error indicator 


GpiCallSegmentMatrix 

EXTRN GpiCallSegmentMatrix: FAR 

INCL_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Segment ; Identifier of segment to be called 

PUSH DWORD 1 Count ; Number of elements 

PUSH® OTHER mat! f Array instance transform matrix 

PUSH DWORD 1 Opt ions ; Trans format ion options 

CALL GpiCallSegmentMatrix 

Returns DWORD lHits ;Correlati on/error indicator 


GpiCharString 

EXTRN GpiCharString: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of characters 

PUSH® OTHER chString ; Characters to be drawn 

CALL GpiCharString 

Returns DWORD lHits ; Correlation/error indicator 


GpiCharStringAt 

EXTRN GpiCharStringAt: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER ptl Point starting position 

PUSH DWORD 1 Count ; Number of characters 

PUSH® OTHER chString ; Characters to be drawn 

CALL GpiCharStringAt 

Returns DWORD lHits ; Correlation/error indicator 


GpiCharStringPos 

EXTRN GpiCharStringPos: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCl_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rclRect ; Rectangle structure 

PUSH DWORD fl Opt ions ; Formatting options 

PUSH DWORD 1 Count ; Number of characters in the string 

PUSH® OTHER chString ; Character string 

PUSH® OTHER alAdx ; Increment values 

CALL GpiCharStringPos 

Returns DWORD lHits ; Correlation/error indicator 
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GpiCharStringPosAt 

EXTRN GpiCharStringPosAt: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps 

PUSH® OTHER ptl Start 

PUSH® OTHER rclRect 

PUSH DWORD fl Options 

PUSH DWORD 1 Count 

PUSH® OTHER chString 

PUSH® OTHER alAdx 

CALL GpiCharStringPosAt 


; Presentation-space handle 
;Starting position 
; Rectangle structure 
; Formatting options 
; Number of characters in the string 
;Character string 
; Increment values 


Returns DWORD lHits ;Correlati on/error indicator 


GpiCloseFigure 

EXTRN GpiCloseFigure: FAR 

INCL_GPI PATHS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiCloseFigure 

Returns WORD f Success ;Success indicator 


GpiCloseSegment 

EXTRN GpiCloseSegment: FAR 

I NCL_GP I SEGMENTS equ 1 ;0r use INCLJSPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiCloseSegment 

Returns WORD f Success ; Success indicator 


GpiCombineRegion 

EXTRN GpiCombineRegion: FAR 

INCLJiPIREGIONS equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD hrgnDest 

PUSH DWORD hrgnSrcl 

PUSH DWORD hrgnSrc2 

PUSH DWORD IMode 

CALL GpiCombineRegion 


; Presentation-space handle 
;Destination-region handle 
; First-source-region handle 
;Second-source-region handle 
;Method of combination 


Returns DWORD 1 Complexity ; Complexity of resulting region/error indicator 


GpiComment 

EXTRN GpiComment: FAR 

I NCL_GPI PRIMITIVES equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Length ;Data length 

PUSH® OTHER bData ; Comment data 

CALL GpiComment 

Returns WORD f Success ; Success indicator 
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GpiConvert 

EXTRN GpiConvert: FAR 

INCL_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL.PM 


PUSH 

DWORD 

hps 

PUSH 

DWORD 

ISrc 

PUSH 

DWORD 

ITarg 

PUSH 

DWORD 

1 Count 

PUSH@ 

OTHER 

aptl Points 

CALL GpiConvert 


; Presentation-space handle 
; Source-coordinate space 
;Target-coordinate space 
; Point count 

; Array of (x,y) coordinate pair structures 


Returns WORD f Success ; Success indicator 


GpiCopyMetaFile 

EXTRN GpiCopyMetaFile: FAR 

INCLJaPIMETAFILES equ 1 ;0r use INCL_GPI or INCLJ>M 

PUSH DWORD hmf ; Source metafile handle 

CALL GpiCopyMetaFile 

Returns DWORD hmf New ;New metafile handle/error indicator 


GpiCorrelateChain 

EXTRN GpiCorrelateChain:FAR 

INCL_GPICORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

lType 

; Segment type 

PUSH© 

OTHER 

ptlPick 

; Pick position 

PUSH 

DWORD 

IMaxHits 

; Maxi mum hits 

PUSH 

DWORD 

IMaxDepth 

; Number of pairs 

PUSHO 

OTHER 

alSegTag 

; Segment identifiers and tags 


CALL GpiCorrelateChain 

Returns DWORD INumHits ; Number of hits or error 


GpiCorrelateFrom 

EXTRN GpiCorrelateFrom: FAR 

INCLJSPICORRELATIQN equ 1 ;0r use INCLJ5PI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

lFirstSegment 

; Specifies the first segment to be correlated 

PUSH 

DWORD 

1 LastSegment 

; Specifies the last segment to be correlated 

PUSH 

DWORD 

lType 

;The type of segments on which correlation is to be performed 

PUSH@ 

OTHER 

ptlPick 

; Pick position 

PUSH 

DWORD 

IMaxHits 

;Maximum hits 

PUSH 

DWORD 

IMaxDepth 

; Number of pairs 

PUSH@ 

OTHER 

alSegTag 

;An array of segment and tag identifiers in alternate elements 


CALL GpiCorrelateFrom 

Returns DWORD INumHits ; Number of hits, or error 
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GpiCorrelateSegment 

EXTRN GpiCorrelateSegment: FAR 

INCLJSPICORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

1 Segment 

; Identifier of the segment to be correlated; it must be greater than 
0 

;Type of segments on which correlation is to be performed 

PUSH 

DWORD 

lType 

PUSH© 

OTHER 

ptlPick 

;Position of the center of the pick aperture in presentation page 
space 

PUSH 

DWORD 

IMaxHits 

;Maximum hits 

PUSH 

DWORD 

IMaxDepth 

; Number of segment and tag pairs to be returned for each hit 

PUSH© 

OTHER 

alSegTag 

; Array 


CALL GpiCorrelateSegment 

Returns DWORD INumHits ; Number of hits, or error 


GpiCreateBitmap 

EXTRN GpiCreateBitmap: FAR 

INCL_GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER bmpNew ; Bit-map information header 

PUSH DWORD fl Options ; Options 

PUSH© OTHER blnitData ; Buffer address 

PUSH© OTHER bmilnfoTable ; Bit-map information table 

CALL GpiCreateBitmap 

Returns DWORD hbm ; Bit-map handle/error indicator 

GpiCreateLogColorT able 

EXTRN GpiCreateLogColorTablerFAR 

INCL GPILOGCOLORTABLE equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

fl Opt ions 

;0ptions 

PUSH 

DWORD 

1 Format 

; Format of entries in the table 

PUSH 

DWORD 

1 Start 

;Starting index 

PUSH 

DWORD 

1 Count 

;Count of elements in Table 

PUSH© 

OTHER 

alTable 

; Start of the application data area 


CALL GpiCreateLogColorTable 

Returns WORD f Success ; Success indicator 


GpiCreateLogFont 

EXTRN GpiCreateLogFont: FAR 

INCL_GPILCIDS equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH© OTHER Name ; Logical font name 

PUSH DWORD ILcid ; Local identifier 

PUSH© OTHER fatAttrs ; Attributes of font 

CALL GpiCreateLogFont 

Returns DWORD 1 Match ; Match indicator 
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GpiCreatePS 

EXTRN GpiCreatePS: FAR 

INCL_GPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 


PUSH 

DWORD 

hab 

PUSH 

DWORD 

hdc 

PUSH® 

OTHER 

sizlSize 

PUSH 

DWORD 

fl Options 

CALL GpiCreatePS 


; Anchor-block handle 
; Device-context handle 
; Presentation-page size 
; Options 


Returns DWORD hps ; Presentation-space handle 


GpiCreateRegion 

EXTRN GpiCreateRegion: FAR 

I NCL_G PI REGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ;The number of rectangles 

PUSHO OTHER arcl Rectangles ;An array of rectangles 

CALL GpiCreateRegion 

Returns DWORD hrgn ; Region handle 

GpiDeleteBitmap 

EXTRN GpiDeleteBitmap: FAR 

I NCL_GPI BITMAPS equ 1 ;0r use INCLJSPI or INCL_PM. Also in COMMON section 

PUSH DWORD hbm ; Handle of bit map to be deleted 
CALL GpiDeleteBitmap 

Returns WORD f Success ; Success indicator 


GpiDeleteElement 

EXTRN GpiDeleteElement: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCLJW 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiDeleteElement 

Returns WORD f Success ; Success indicator 


GpiDeleteElementRange 

EXTRN GpiDeleteElementRange: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lFirstElement ; Number of the first element to be deleted 

PUSH DWORD 1 Last Element ; Number of the last element to be deleted 

CALL GpiDeleteElementRange 

Returns WORD f Success ; Success indicator 


GpiDeleteElementsBetweenLabels 

EXTRN Gpi Del eteEl ementsBetween Label s : FAR 
INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lFirstLabel ; Label marking the start of the elements to be deleted 

PUSH DWORD lLastLabel ; Label marking the end of the elements to be deleted 

CALL Gpi Del eteEl ementsBetweenLabel s 

Returns WORD f Success ; Success indicator 
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GpiDeleteMetaFile 

EXTRN Gpi Del eteMetaFi 1 e: FAR 

INCL_GPIMETAFILES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hmf Metafile handle 
CALL GpiDeleteMetaFile 

Returns WORD f Success ; Success indicator 


GpiDeleteSegment 

EXTRN GpiDeleteSegment: FAR 

INCL_GPISEGMENTS equ 1 ;Or use INCL_GPI or INCLJ>M 

PUSH DWORD bps ; Presentation-space handle 

PUSH DWORD lSegid ;Segment identifier 

CALL GpiDeleteSegment 

Returns WORD fSuccess ; Success indicator 


GpiDeleteSegments 

EXTRN GpiDeleteSegments: FAR 

I NCL_GP I SEGMENTS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 First Segment ; First identifier in the range; it must be greater than 0 
PUSH DWORD ILastSegment ;Last identifier in the range; it must be greater than 0 
CALL GpiDeleteSegments 

Returns WORD fSuccess ; Success indicator 


GpiDeleteSetld 

EXTRN GpiDeleteSetld: FAR 

INCL_GPILCIDS equ 1 ;Qr use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ILcid ; Local identifier 

CALL GpiDeleteSetld 

Returns WORD fSuccess ;Success indicator 


GpiDestroyPS 

EXTRN GpiDestroyPS: FAR 

INC L_GP I CONTROL equ 1 ;Or use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiDestroyPS 

Returns WORD fSuccess -.Success indicator 


GpiDestroyRegion 

EXTRN GpiDestroyRegion: FAR 

INCL_GPIREGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgn ; Handle of region to be destroyed 

CALL GpiDestroyRegion 

Returns WORD fSuccess ; Success indicator 
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GpiDrawChain 

EXTRN GpiDrawChain:FAR 

INCL_GPISEGMENTS equ 1 ;0r use INCL.GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiDrawChain 

Returns WORD f Success ; Success indicator 


GpiDrawDynamics 

EXTRN GpiDrawDynamics: FAR 

INCL_GP I SEGMENTS equ 1 ;Or use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiDrawDynamics 

Returns WORD f Success ; Success indicator 


GpiDrawFrom 

EXTRN GpiDrawFrom: FAR 

INCL_GPISEGMENTS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lFirstSegment ; First segment to be drawn; it must be greater than zero 

PUSH DWORD lLastSegment ;Last segment to be drawn; it must be greater than zero 

CALL GpiDrawFrom 

Returns WORD f Success ; Success indicator 


GpiDrawSegment 

EXTRN GpiDrawSegment: FAR 

INCL_GPISEGMENTS equ 1 ;0r use INCLJPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Segment ; Segment to be drawn; it must be greater than zero 

CALL GpiDrawSegment 

Returns WORD f Success ; Success indicator 


GpfElement 

EXTRN Gpi Element: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCLJ3PI or INCL_PM 


PUSH 

DWORD 

hps 

PUSH 

DWORD 

lType 

PUSH® 

ASCIIZ 

szDesc 

PUSH 

DWORD 

1 Length 

PUSH® 

OTHER 

bData 

CALL Gpi Element 


; Presentation-space handle 

;Type to be associated with the element 

; Element description 

; Length of content data for the element 

; Buffer pointer 


Returns DWORD IHits ; Correlation/error indicator 


GpiEndArea 

EXTRN GpiEndArea: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiEndArea 

Returns DWORD IHits ; Correlation/error indicator 
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GpiEndElement 

EXTRN GpiEndElement: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiEndElement 

Returns WORD fSuccess ;Success indicator 


GpiEndPath 

EXTRN GpiEndPath: FAR 

INCL_GPIPATHS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ;Presentati on-space handle 
CALL GpiEndPath 

Returns WORD fSuccess ;Success indicator 


GpiEqualRegion 

EXTRN GpiEqualRegion: FAR 

I NCL_G PI REGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgnSrcl ; Handle of first region 

PUSH DWORD hrgnSrc2 ;Handle of second region 

CALL GpiEqualRegion 

Returns DWORD 1 Equality ; Equal ity /error indicator 


GpiErase 

EXTRN GpiErase: FAR 

INCL_GPICONTROL equ 1 ;Or use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiErase 

Returns WORD fSuccess ; Success indicator 


GpiErrorSegmentData 

EXTRN GpiErrorSegmentData: FAR 

INCLJaPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® DWORD 1 Segment ; Segment in which the error occurred 

PUSH® DWORD 1 Context ; Context of the error 

CALL GpiErrorSegmentData 

Returns DWORD lOff ; Position 


GpiExcludeClipRectangle 

EXTRN Gpi Excl udeCl i pRect angl e : FAR 

INCLJ2PI REGIONS equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rcl Rectangle ; Rectangle to be excluded 
CALL GpiExcludeClipRectangle 

Returns DWORD 1 Complexity ; Complexity of clipping/error indicator 
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GpiFillPath 

EXTRN GpiFillPath: FAR 

INCL_GPIPATHS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IPath ; Identifier of path whose interior is to be drawn; it must be 1 

PUSH DWORD 1 Options ; Fi 1 1 option 

CALL GpiFillPath 

Returns DWORD lHits ; Error indicator 


GpiFullArc 

EXTRN GpiFullArc: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Control ;Interior/outl ine control 

PUSH DWORD fxMultiplier ;Multiplier 

CALL GpiFullArc 

Returns DWORD lHits ; Correlation/error indicator 


GpiGetData 

EXTRN GpiGetData: FAR 

INCL GPISEGMENTS equ 1 ;Or use INCLJ3PI or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH® DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 


hps ; Presentation-space handle 
lSegid ; Segment identifier 
1 Offset ; Segment offset 
1 Format ; Coordinate type required 
1 Length ; Length of data buffer 
bData ;Data buffer 


CALL GpiGetData 


Returns DWORD 1 Count ; Length of returned data 


Gpilmage 

EXTRN Gpilmage: FAR 
INCL_GPIPRIMITIVES equ 1 

PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 
PUSH DWORD 
PUSH® OTHER 
CALL Gpilmage 

Returns DWORD lHits 


;Or use INCL_GPI or INCL_PM 


; Correlation/error indicator 


hps ; Presentation-space handle 

1 Format ; Format of image data 

sizlImageSize ;Size of image area (in pels) 

1 Length ; Length in bytes of image data 

bData ; Image data 


GpilntersectClipRectangle 

EXTRN Gpi IntersectCl i pRectangl e : FAR 
INCLGPIREGIONS equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rcl Rectangle ; Rectangle, the coordinates of which are world coordinates 

CALL GpilntersectClipRectangle 

Returns DWORD 1 Complexity ; Complexity of clipping/error indicator 
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GpiLabel 

EXTRN GpiLabel: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Label Required label 

CALL GpiLabel 

Returns WORD f Success ; Success indicator 


GpiLine 

EXTRN GpiLine: FAR 

INCL_GPIPRIMITIVES equ 1 ;Or use INCL.GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER ptl EndPoint ;End point of the line 

CALL GpiLine 

Returns DWORD 1 Hits ;Correl at ion/error indicator 


GpiLoadBitmap 

EXTRN GpiLoadBitmap: FAR 

INCL.GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH WORD Resource ; Resource identity containing the bit map 

PUSH WORD idBitmap ; ID of the bit map within the resource file 

PUSH DWORD 1 Width ;Width of the bit map in pels 

PUSH DWORD 1 Height ; Height of the bit map in pels 

CALL GpiLoadBitmap 

Returns DWORD hbm ;Bit-map handle 


GpiLoadFonts 

EXTRN GpiLoadFonts: FAR 

INCL_GPI LCIDS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH@ ASCIIZ szFilename ; Filename 
CALL GpiLoadFonts 

Returns WORD fSuccess ; Success indicator 


GpiLoadMetaFile 

EXTRN GpiLoadMetaFile: FAR 

INCL_GPIMETAFILES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 

PUSHO ASCIIZ szFilename ; Filename 
CALL GpiLoadMetaFile 

Returns DWORD hmf ;Metafile handle or error 


GpiMarker 

EXTRN GpiMarker: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER ptl Point position of the marker 
CALL GpiMarker 

Returns DWORD IHits ; Correlation/error indicator 
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GpiModifyPath 

EXTRN GpiModifyPath: FAR 

INCL_GPI PATHS equ 1 ;0r use INCLJ3PI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD 1 Path 

PUSH DWORD IMode 

CALL GpiModifyPath 


; Presentation-space handle 
;Path identifier 
;Modifi cation required 


Returns WORD f Success ; Success indicator 


GpiMove 

EXTRN GpiMove: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL.GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER ptl Point ; Position to which to move 
CALL GpiMove 

Returns WORD f Success ; Success indicator 


GpiOffsetClipRegion 

EXTRN GpiOffsetClipRegion: FAR 

INCL_GPIREGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER ptl Point ; Displacement 

CALL GpiOffsetClipRegion 

Returns DWORD 1 Complexity ; Complexity of clipping/error indicator 


GpiOffsetElementPointer 

EXTRN Gpi Of f set El ementPoi nter : FAR 
INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 offset ; Offset to be added to the element pointer 

CALL GpiOffsetElementPointer 

Returns WORD f Success ;Success indicator 


GpiOffsetRegion 

EXTRN GpiOffsetRegion: FAR 

I NCL_GPI REGIONS equ 1 ;0r use INCLGPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD Hrgn ; Region handle to be moved 

PUSH® OTHER ptl Offset ; Offset to be added to the region boundary 

CALL GpiOffsetRegion 

Returns WORD f Success ; Success indicator 


GpiOpenSegment 

EXTRN Gpi OpenSegment : FAR 

INCL_GPI SEGMENTS equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
PUSH DWORD 1 Segment ; Segment identifier 
CALL GpiOpenSegment 

Returns WORD f Success ; Success indicator 
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GpiOutlinePath 

EXTRN GpiOutlinePath: FAR 

INCL_GPIPATHS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IPath ; Identifier of path to be outlined; it must be 1 

PUSH DWORD 1 Options ;0ptions 
CALL GpiOutlinePath 

Returns DWORD 1 Hits ;Correlati on/error indicator 


GpiPaintRegion 

EXTRN GpiPaintRegion: FAR 

INCL_GPIREGIONS equ 1 ;Or use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgn ; Region handle 

CALL GpiPaintRegion 

Returns DWORD lHits ;Correlati on/error indicator 


GpIPartialArc 

EXTRN Gpi Partial Arc: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 


i r i coci i l>u b i uiropu^c 


PUSH DWORD hps 

PUSH® OTHER ptl Center ; Center point 

PUSH DWORD fxMultiplier -.Multiplier 

PUSH DWORD fxStartAngle ; Start angle in degrees 

PUSH DWORD fxSweepAngle ; Sweep angle in degrees 

CALL Gpi Partial Arc 


Returns DWORD lHits ; Correlation/error indicator 


GpiPlayMetaFile 

EXTRN GpiPlayMetaFile: FAR 

INCLJ3PIMETAFILES equ 1 ;0r use INCL GPI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD hmf 

PUSH DWORD ICountl 

PUSH® OTHER alOptarray 
PUSH® DWORD lSegCount 

PUSH DWORD lCount2 

PUSH® ASCIIZ szDesc 

CALL GpiPlayMetaFile 


; Presentation-space handle 
Metafile handle 
; Count of elements in Optarray 
; Array of options for playing 
Reserved 

; Count of bytes in Desc 
; Descriptive record 


Returns DWORD lHits ; Correlation/error indicator 


GpiPointArc 

EXTRN GpiPointArc: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER apt 1 Points ; Intermediate and end points 
CALL GpiPointArc 

Returns DWORD lHits ; Correlation/error indicator 


Chapter 4. Graphics Presentation Interface Function Calls 4-13 



GpiPolyFillet 

EXTRN GpiPolyFillet: FAR 

INCL.GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of points 

PUSH® OTHER aptl Points ;Array of points 

CALL GpiPolyFillet 

Returns DWORD lHits ; Correlation/error indicator 


GpiPolyFilletSharp 

EXTRN GpiPolyFilletSharp: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Count of points 

PUSH® OTHER aptl Points ;An array of points 

PUSH® OTHER afxSharpness ; Array of sharpness values 

CALL GpiPolyFilletSharp 

Returns DWORD lHits ; Correlation/error indicator 


GpiPolyLine 

EXTRN GpiPolyLine:FAR 

INCL.GPIPRIMITIVES equ 1 ;Or use INCL_GPI or INCL.PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of points 

PUSH® OTHER aptl Points ; Array of points 

CALL GpiPolyLine 

Returns DWORD lHits ; Correlation/error indicator 


GpiPolyMarker 

EXTRN GpiPolyMarker: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of points 

PUSH® OTHER aptl Points ; Array of points 

CALL GpiPolyMarker 

Returns DWORD lHits ; Correlation/error indicator 


GpiPolySpline 

EXTRN GpiPolySpline: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Count of points 

PUSH® OTHER aptl Points ;An array of points 

CALL GpiPolySpline 

Returns DWORD lHits ;Correlati on/error indicator 


GpiPop 

EXTRN GpiPop: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of attributes to be restored 

CALL GpiPop 

Returns WORD f Success ; Success indicator 
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GpiPtlnRegion 

EXTRN GpiPtlnRegion: FAR 

I NCLGPI REGIONS equ 1 ;0r use INCL_GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgn ; Region handle 

PUSH® OTHER ptl Point ;Point to be checked 
CALL GpiPtlnRegion 

Returns DWORD 1 Inside ; Inside/error indicator 


GpiPtVisible 

EXTRN GpiPtVisible: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER ptl Point ; Point to be checked 

CALL GpiPtVisible 

Returns DWORD lVisibility ; Vi sibi 1 i ty indicator 


GpiPutData 

EXTRN GpiPutData: FAR 

INCL_GPISEGMENTS equ 1 ;0r use INCL.GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Format ; Coordinate type used 

PUSH® DWORD 1 Length ; Length of graphic data 

PUSH® OTHER bData ;0rders to be copied 

CALL GpiPutData 

Returns DWORD lHits ; Correlation/error indicator 


GpiQueryArcParams 

EXTRN GpiQueryArcParams: FAR 

INCLJ3PI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER arcpArcParams ;Arc parameters 

CALL GpiQueryArcParams 

Returns WORD fSuccess ;Success indicator 


GpiQueryAttrMode 

EXTRN GpiQueryAttrMode: FAR 

INCL_GPIPRIMITI VES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ;Presentati on-space handle 
CALL GpiQueryAttrMode 

Returns DWORD IMode ; Current attribute mode 


GpiQueryAttrs 

EXTRN GpiQueryAttrsiFAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD IPrimType 

PUSH DWORD flAttrMask 

PUSH® OTHER pbunAttrs 

CALL GpiQueryAttrs 


;Presentation-space handle 
primitive type 
attributes mask 
attributes 


Returns DWORD IDefMask ; Defaults mask 
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GpiQueryBackColor 

EXTRN GpiQueryBackColor: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryBackColor 

Returns DWORD 1 Col or ; Background color 


GpiQueryBackMix 

EXTRN GpiQueryBackMix: FAR 

INCLJSPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryBackMix 

Returns DWORD IMixMode ; Background mix 


GpiQueryBitmapBits 

EXTRN GpiQueryBitmapBits: FAR 

INCL_GPIBITMAPS equ 1 ;0r use INCLJ3PI or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 
PUSH® OTHER 


hps 

IScanStart 
1 Scans 
bBuffer 
bmilnfoTable 


CALL GpiQueryBitmapBits 


; Presentation-space handle 
; Starting line number 
; Number of scan lines to be returned 
;Data area 

; Bit-map information table 


Returns DWORD IScansReturned ;Number of scan lines actually returned 


GpiQueryBitmapDimension 

EXTRN Gpi QueryBi tmapDi mens i on : FAR 
INCLJ3PIBITMAPS equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hbm ;Bit-map handle 

PUSH® OTHER sizlBitmapDimension ;Size of bit map 
CALL GpiQueryBitmapDimension 

Returns WORD f Success ; Success indicator 


GpiQueryBitmapHandle 

EXTRN GpiQueryBitmapHandle: FAR 

INCL_GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ILcid ; Local identifier 

CALL GpiQueryBitmapHandle 

Returns DWORD hbm ; Bit-map handle 


GpiQueryBitmapParameters 

EXTRN Gpi QueryBi tmapParameters : FAR 
INCL_GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hbm ;Bit-map handle 

PUSH® OTHER bmpData ; Bit-map information header 

CALL GpiQueryBitmapParameters 

Returns WORD f Success ; Success indicator 
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GpiQueryBoundaryData 

EXTRN GpiQueryBoundaryData: FAR 

INCLJaPICORRELATION equ 1 ;0r use INCLJaPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rcl Boundary ; Boundary data 
CALL GpiQueryBoundaryData 

Returns WORD f Success ; Success indicator 


GpiQueryCharAngle 

EXTRN GpiQueryCharAngle: FAR 

INCL_GPIPRIMITIVE$ equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER gradl Angle ; Baseline angle 

CALL GpiQueryCharAngle 

Returns WORD fSuccess ; Success indicator 


GpiQueryCharBox 

EXTRN Gpi QueryCharBox : FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCLJaPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER sizfxSize ; Character-box size 

CALL GpiQueryCharBox 

Returns WORD fSuccess ; Success indicator 


GpiQueryCharDirection 

EXTRN GpiQueryCharDirection: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCLJaPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryCharDirection 

Returns DWORD 1 Direction Character direction 


GpiQueryCharMode 

EXTRN GpiQueryCharMode: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryCharMode 

Returns DWORD IMode ; Character mode 


GpiQueryCharSet 

EXTRN GpiQueryCharSet: FAR 

INCLJaPIPRIMITIVES equ 1 ;Or use INCLJaPI or INCLJW 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryCharSet 

Returns DWORD ILcid ; Character-set local identifier 


GpiQueryCharShear 

EXTRN GpiQueryCharShear: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER ptl Shear Character shear 

CALL GpiQueryCharShear 

Returns WORD fSuccess ; Success indicator 
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GpiQueryCharStringPos 

EXTRN GpiQueryCharStringPos: FAR 

INCL.GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH 

PUSH 

PUSH 

PUSH© 

PUSH© 

PUSH© 


DWORD 

DWORD 

DWORD 

OTHER 

OTHER 

OTHER 


hps 

fl Options 
1 Count 
chStri ng 
alXincrements 
apt! Positions 


; Presentation-space handle 

; Opt ion flag 

; Length of the string 

;The character string to be examined 

; Vector of x increment values 

; Array of points 


CALL GpiQueryCharStringPos 


Returns WORD f Success ; Success indicator 


GpiQueryCharStringPosAt 

EXTRN Gpi QueryCharStri ngPosAt : FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCLJ3PI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH© 

OTHER 

ptl Start 

;Starting position 

PUSH 

DWORD 

fl Opt ions 

;0ption flags 

PUSH 

DWORD 

1 Count 

; Length of the string 

PUSH© 

OTHER 

chStri ng 

Character string to be examined 

PUSH© 

OTHER 

alXincrements 

; Vector of x increment values 

PUSH© 

OTHER 

aptl Positions 

;Array of points, in which the positions of each character in 


world coordinates are returned 

CALL GpiQueryCharStringPosAt 


Returns WORD fSuccess ; Success indicator 


GpiQueryClipBox 

EXTRN GpiQueryClipBox: FAR 

INCL_GPIREGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rcl Bound founding rectangle 

CALL GpiQueryClipBox 

Returns DWORD 1 Complexity ; Complexity /error indicator 


GpiQueryClipRegion 

EXTRN GpiQueryClipRegion: FAR 

INCL_GPIREGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryClipRegion 

Returns DWORD hrgn ;C1 ip- region handle (if any) 


GpiQueryColor 

EXTRN GpiQueryColor: FAR 

INCLJ5PI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryColor 

Returns DWORD 1 Col or ; Col or attribute 
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GpiQueryColorData 

EXTRN GpiQueryColorData: FAR 

INCLJ3PI LOGCOLORTABLE equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of elements 

PUSHG OTHER al Array ; Array 

CALL GpiQueryColorData 

Returns WORD f Success ; Success indicator 


GpiQueryColorlndex 

EXTRN GpiQueryColorlndex: FAR 

INC L_GP I LOGCOLORTABLE equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD fl Options ; Opt ions 

PUSH DWORD lRgbColor ; Specifies a color in RGB terms 
CALL GpiQueryColorlndex 

Returns DWORD 1 Index ; Col or index providing closest match to the specified color 


GpiQueryCp 

EXTRN GpiQueryCp: FAR 

INCL_GPILCIDS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryCp 

Returns WORD usCodePage ;Code page 


GpiQueryCurrentPosition 

EXTRN Gpi QueryCurrentPosi t i on : FAR 
INCLJ3PIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER ptl Point ;Current position 

CALL GpiQueryCurrentPosition 

Returns WORD f Success ; Success indicator 


GpiQueryDefArcParams 

EXTRN GpiQueryDefArcParams: FAR 

INCL_GPIDEFAULTS equ 1 ;0r use INCLGPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER arcpArcParams ; Default arc parameters 
CALL GpiQueryDefArcParams 

Returns WORD f Success ; Success indicator 


GpiQueryDefAttrs 

EXTRN GpiQueryDefAttrs: FAR 

I NCL_GPI DEFAULTS equ 1 ;0r use INCL_GPI or INCLJ>M 


PUSH DWORD hps 

PUSH DWORD IPrimType 

PUSH DWORD flAttrMask 

PUSH@ OTHER pbunAttrs 

CALL GpiQueryDefAttrs 


jnresentati on-space nanan 
; Primitive type 
attributes mask 
attributes 


Returns WORD f Success ; Success indicator 
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GpiQueryDefauItViewMatrix 

EXTRN GpiQueryDefauItViewMatrix: FAR 
INCL_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of elements 

PUSH@ OTHER matlfArray transform matrix 

CALL GpiQueryDefauItViewMatrix 

Returns WORD fSuccess ; Success indicator 


GpiQueryDefCharBox 

EXTRN GpiQueryDefCharBox: FAR 

INCLJ3PIPRIMITIVES equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
PUSH® OTHER si zl Size ; Default character-box size 
CALL GpiQueryDefCharBox 

Returns WORD fSuccess ; Success indicator 


GpiQueryDefTag 

EXTRN GpiQueryDefTag: FAR 

I NCL_GPI DEFAULTS equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ DWORD ITag ; Default tag identifier 

CALL GpiQueryDefTag 

Returns WORD fSuccess ; Success indicator 


GpiQueryDefViewingLimits 

EXTRN Gpi QueryDef Vi ewi ngLi mi ts : FAR 
INCLJ3PIDEFAULTS equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER rclLimits ;Default viewing limits 
CALL GpiQueryDefViewingLimits 

Returns WORD fSuccess ; Success indicator 


GpiQueryDevice 

EXTRN GpiQueryDevice: FAR 

I NCL_GPI CONTROL equ 1 ;0r use INCL.GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryDevice 

Returns DWORD hdc ; Device-context handle 


GpiQueryDeviceBitmapFormats 

EXTRN Gpi QueryDevi ceBi tmapFormats : FAR 
INCLJJPIBITMAPS equ 1 ;Or use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of elements 

PUSHO OTHER al Array ;Data array 

CALL GpiQueryDeviceBitmapFormats 

Returns WORD fSuccess ; Success indicator 
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GpiQueryDrawControl 

EXTRN GpiQueryDrawControl : FAR 

INCL.GPICONTROL equ 1 ;0r use INCLJSPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Control ;Control whose value is to be returned 

CALL GpiQueryDrawControl 

Returns DWORD 1 Value ; Value of the control 


GpiQueryDrawingMode 

EXTRN GpiQueryDrawingMode: FAR 

INCLGPICONTROL equ 1 ;0r use INCLGPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryDrawingMode 

Returns DWORD IMode ; Drawing mode 


GpiQueryEditMode 

EXTRN GpiQueryEditMode: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ;Presentati on-space handle 
CALL GpiQueryEditMode 

Returns DWORD IMode ; Current editing mode 


GpiQueryElement 

EXTRN GpiQueryElement: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCLGPI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

lOff 

; Starting byte offset within the element 

PUSH 

DWORD 

IMaxLength 

;Maximum length of data that can be returned 

PUSH@ 

OTHER 

bData 

; Element content data 


CALL GpiQueryElement 

Returns DWORD 1 Ret Length ; Number of bytes returned 

GpiQueryElementPointer 

EXTRN GpiQueryElementPointer: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryElementPointer 

Returns DWORD 1 Element ; Current element pointer 


GpiQueryElementT ype 

EXTRN GpiQueryElementType:FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ DWORD lType ; Element type 

PUSH DWORD 1 Length ;Data length 

PUSH@ ASCI IZ szData description of data buffer 

CALL GpiQueryElementType 

Returns DWORD IReqLength ;Size of the data required to hold the element content 
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GpiQueryFontFileDescriptions 

EXTRN Gpi Query Font Fi 1 eDescripti ons : FAR 
INCL_GPI LCIDS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCIIZ szFilename ;Fully qualified filename 

PUSH® DWORD ICount ;Maximum number of family and facename pairs to be returned 

PUSH® OTHER affdescsNames ; Array of font file descriptors 
CALL Gpi QueryFont Fi 1 eDescri pti ons 

Returns DWORD IRemFonts ‘.Returns 


GpiQueryFontMetrics 

EXTRN GpiQueryFontMetrics: FAR 

INCL_GPI LCIDS equ 1 ;0r use INCL_GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMetricsLength ; Length of metrics 

PUSH® OTHER fmMetrics ;Metrics of font 

CALL GpiQueryFontMetrics 

Returns WORD fSuccess ;Success indicator 


GpiQueryFonts 

EXTRN GpiQueryFonts: FAR 

INCL_GPI LCIDS equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD fl Opt ions 

PUSH® ASCIIZ szFacename 

PUSH® DWORD IReqFonts 

PUSH DWORD IMetricsLength 

PUSH® OTHER afmMetrics 

CALL GpiQueryFonts 


; Presentation-space handle 
; Enumeration options 
; Facename of fonts 
; Count of fonts 
; Length of metrics 
;Metrics of font 


Returns DWORD IRemFonts ;Count of fonts not returned 


GpiQueryGraphicsField 

EXTRN GpiQueryGraphicsField: FAR 

INCL_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rcl Field ; Graphics field 

CALL GpiQueryGraphicsField 

Returns WORD fSuccess ;Success indicator 


GpiQuerylnitialSegmentAttrs 

EXTRN Gpi Query Ini ti al SegmentAttrs : FAR 
INCL_GPISEGMENTS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ;Presentati on-space handle 

PUSH DWORD 1 Attribute ; Attribute to be queried 
CALL GpiQuerylnitialSegmentAttrs 

Returns DWORD lValue ;Current initial attribute value 


4-22 PM Macro Assembler/2 Bindings Reference 



GpiQueryKerningPairs 

EXTRN GpiQueryKerningPairs: FAR 

INCL_GPILCIOS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ;The number of elements in Data 

PUSH@ OTHER akrnprData ; Kerning pairs 
CALL GpiQueryKerningPairs 

Returns DWORD 1 Returned ;Number returned/error indicator 


GpiQueryLineEnd 

EXTRN GpiQueryLineEnd: FAR 

INCLJ5PIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryLineEnd 

Returns DWORD ILineEnd ;Line end 


GpiQueryLineJoin 

EXTRN GpiQueryLineJoin: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryLineJoin 

Returns DWORD ILineJoin ;Line join 


GpiQueryLineType 

EXTRN GpiQueryLineType: FAR 

INCLJ5PIPRIMITIVES equ 1 ;0r use INCL.GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryLineType 

Returns DWORD ILineType ;Line type 


GpiQueryLineWidth 

EXTRN GpiQueryLineWidth: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryLineWidth 

Returns DWORD fxLineWidth ;Line width 


GpiQueryLineWidthGeom 

EXTRN GpiQueryLineWidthGeom:FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryLineWidthGeom 

Returns DWORD ILineWidth ; Geometric line width 
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GpiQueryLogColorTable 

EXTRN GpiQueryLogColorTable: FAR 

INCL_GPILOGCOLORTABLE equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD fl Options ; Specifies options 

PUSH DWORD 1 Start ;The starting index for which data is to be returned 

PUSH DWORD 1 Count ; Count of elements 

PUSH© OTHER al Array ;An array in which the information is returned 

CALL GpiQueryLogColorTable 

Returns DWORD IRetCount ; Number of elements returned/error indicator 


GpiQueryMarker 

EXTRN GpiQueryMarker: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryMarker 

Returns DWORD 1 Symbol ; Marker symbol 


GpiQueryMarkerBox 

EXTRN Gpi QueryMarkerBox : FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER sizfxSize ;Size of marker box 
CALL GpiQueryMarkerBox 

Returns WORD f Success ; Success indicator 


GpiQueryMarkerSet 

EXTRN GpiQueryMarkerSet: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCLJ3PI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryMarkerSet 

Returns DWORD lSet ;Marker set local identifier 


GpiQueryMetaFileBits 

EXTRN GpiQueryMetaFileBits: FAR 

INCL_GPIMETAFILES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hmf ;Memory-metafile handle 

PUSH DWORD 1 Offset ;Byte offset 

PUSH DWORD 1 Length ; Length in bytes of the metafile data to copy 

PUSH® OTHER bData Metafile data 

CALL GpiQueryMetaFileBits 

Returns WORD f Success ; Success indicator 


GpiQueryMetaFileLength 

EXTRN GpiQueryMetaFileLength: FAR 

INCL_GPIMETAFILES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hmf ; Memory -met afi le handle 

CALL GpiQueryMetaFileLength 

Returns DWORD 1 Length ;Total length of the metafile 
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GpiQueryMix 

EXTRN GpiQueryMix: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryMix 

Returns DWORD IMixMode ;Mix mode 


GpiQueryModelTransform Matrix 

EXTRN Gpi QueryModel TransformMat ri x : FAR 
INCL.GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ;Number of elements 

PUSH® OTHER matlfArray transform matrix 
CALL Gpi QueryModel TransformMatrix 

Returns WORD f Success ; Success indicator 


GpiQueryNearestColor 

EXTRN GpiQueryNearestColor: FAR 

INCL_GPI LOGCOLORTABLE equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD flOptions ;0ptions 

PUSH DWORD lRgbln Required color 

CALL GpiQueryNearestColor 

Returns DWORD lRgbOut ; Nearest available color to the one specified 


GpiQueryNumberSetlds 

EXTRN GpiQueryNumberSetlds: FAR 

INCL_GPILCIDS equ 1 ;0r use INOGPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryNumberSetlds 

Returns DWORD 1 Count ; Number of lcids 


GpiQueryPageViewport 

EXTRN GpiQueryPageViewport: FAR 

INCLJSPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rclViewport ;Page viewport 

CALL GpiQueryPageViewport 

Returns WORD f Success ; Success indicator 


GpiQueryPattern 

EXTRN GpiQueryPattern: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiQueryPattern 

Returns DWORD 1 PatternSymbol ; Pattern symbol 
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GpiQueryPatternRefPoint 

EXTRN Gpi Query PatternRef Poi nt : FAR 
INCL.GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ;Presentati on-space handle 

PUSHO OTHER ptl Ref Point ; Pattern reference point 
CALL GpiQueryPatternRefPoint 

Returns WORD fSuccess ;$uccess indicator 


GpiQueryPatternSet 

EXTRN GpiQueryPatternSet: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCLJSPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryPatternSet 

Returns DWORD lSet ; Pattern-set local identifier 


GpiQueryPel 

EXTRN GpiQueryPel: FAR 

INCL.GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
PUSHO OTHER ptl Point position in world coordinates 
CALL GpiQueryPel 

Returns DWORD 1 Col or ; Col or index of the pel 


GpiQueryPickAperturePosition 

EXTRN Gpi QueryPi ckAperturePosi t i on : FAR 
INCLJ3PIC0RRELATI0N equ 1 ;0r use INCLJ.PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
PUSHO OTHER ptl Point ; Pi ck aperture position 
CALL Gpi QueryPi ckAperturePos i ti on 

Returns WORD fSuccess ; Success indicator 


GpiQueryPickApertureSize 

EXTRN Gpi QueryPi ckApertureSi ze : FAR 
I NC L_GP I CORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
PUSH@ OTHER si zl Size ; Pi ck aperture size 
CALL GpiQueryPickApertureSize 

Returns WORD fSuccess ; Success indicator 


GpiQueryPS 

EXTRN GpiQueryPS: FAR 

INCL_GPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER si zl Size ; Presentation-page size 

CALL GpiQueryPS 

Returns DWORD fl Opt ions ; Presentation-space options 
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GpiQueryRealColors 

EXTRN GpiQueryRealColors: FAR 

INCLJ3PIL0GC0L0RTABLE equ 1 ;0r use INCLJ3PI or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 


hps ; Presentation-space handle 

flOptions ;0ptions 

1 Start ; Ordinal number of the first color required 

1 Count -.Maximum number of elements 

al Colors ; Array in which the information is returned 


CALL GpiQueryRealColors 


Returns DWORD IRetCount ; Number of elements returned 


GpiQueryRegionBox 

EXTRN GpiQueryRegionBox: FAR 

INCLJ3PIREGI0NS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgn ; Region handle 

PUSH® OTHER rcl Bound ; Bounding rectangle 

CALL GpiQueryRegionBox 

Returns DWORD 1 Complexity Complexity of region/error indicator 


GpiQueryRegionRects 

EXTRN GpiQueryRegionRects: FAR 

INCL_GPIREGIONS equ 1 ;0r use INCLJ5PI or INCL.PM 


PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 
PUSH® OTHER 
PUSH® OTHER 


hps 

hrgn 

rcl Bound 

rgnrcControl 

arclRects 


CALL GpiQueryRegionRects 


; Presentation-space handle 
; Region handle 
; Bounding rectangle 
; Processing-control structure 

; Array of rectangle structures, in which the rectangles are 
returned 


Returns WORD f Success ; Success indicator 


GpiQueryRGBColor 

EXTRN GpiQueryRGBColor: FAR 

INCLJaPI LOGCOLORTABLE equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD flOptions ;0ptions 

PUSH DWORD IColorIndex Color index 

CALL GpiQueryRGBColor 

Returns DWORD lRgbColor ;RGB color providing closest match to the specified color index 


GpiQuerySegmentAttrs 

EXTRN GpiQuerySegmentAttrs CAR 

INCLJ3PISEGMENTS equ 1 ;0r use INCLJaPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lSegid ; Segment identifier; must be greater than 0 

PUSH DWORD 1 Attribute ; Attribute to be queried 

CALL GpiQuerySegmentAttrs 

Returns DWORD 1 Value Current attribute value 
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GpiQuerySegmentNames 

EXTRN GpiQuerySegmentNames: FAR 

INCL_GPISEGMENTS equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lFirstSegid ; First segment in the range; must be greater than 0 

PUSH DWORD lLastSegid ;Last segment in the range; must be greater than 0 
PUSH DWORD IMax ;Maximum number 

PUSHO OTHER alSegids ; Array in which the required identifiers are returned 

CALL GpiQuerySegmentNames 

Returns DWORD IRetCount 


; Number of identifiers returned 


GpiQuerySegmentPriority 

EXTRN Gpi QuerySegmentPri ori ty : FAR 
INCLJjPISEGMENTS equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IRefSegid ; Reference segment identifier 

PUSH DWORD 1 Order ; Segment higher or lower 

CALL GpiQuerySegmentPriority 

Returns DWORD lSegid ; Segment identifier 


GpiQuerySegmentTransformMatrix 

EXTRN Gpi QuerySegmentTransformMatri x : FAR 
INCL_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lSegid ; Segment identifier 

PUSH DWORD 1 Count ; Number of elements 

PUSH© OTHER matlfArray -.Transform matrix 

CALL Gpi QuerySegmentTransformMatri x 


Returns WORD fSuccess ; Success indicator 


GpiQuerySetlds 

EXTRN GpiQuerySetlds: FAR 


INCL_GPILCIDS 

equ 1 

;0r use INCLJ5PI or INCL_PM 

PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

1 Count 

;The number of objects to be queried 

PUSHO 

OTHER 

al Types 

; Object types 

PUSH@ 

OTHER 

aNames 

;Font names 

PUSHO 

OTHER 

allcids 

; Local identifiers 

CALL GpiQuerySetlds 


Returns WORD 

fSuccess 

; Success indicator 


GpiQueryStopDraw 

EXTRN GpiQueryStopDraw: FAR 

I NCL_G PI CONTROL equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiQueryStopDraw 

Returns DWORD 1 Value ;Stop draw condition indicator 
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GpiQueryTag 

EXTRN GpiQueryTag: FAR 

INCL_GPICORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO DWORD ITag ;Tag identifier 

CALL GpiQueryTag 

Returns WORD f Success ; Success indicator 


GpiQueryTextBox 

EXTRN GpiQueryTextBox: FAR 

INCL_GPIPRIMITIVES equ 1 ;Or use INCLJ5PI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD 1 Count 1 

PUSH© OTHER chString 

PUSH DWORD 1 Count2 

PUSH® OTHER aptl Points 

CALL GpiQueryTextBox 


; Presentation-space handle 
; Number of characters 
;The character string 
; Number of points 
; Li st of points 


Returns WORD f Success ; Success indicator 


GpiQueryViewingLimits 

EXTRN GpiQueryViewingLimits:FAR 

INCLJ5PITRANSF0RMS equ 1 ;Or use INCLJSPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH© OTHER rcl Limits ; Viewing limits 
CALL GpiQueryViewingLimits 

Returns WORD f Success ; Success indicator 


GpiQueryViewingTransformMatrix 

EXTRN Gpi Query Vi ewi ngT ransf ormMatri x : FAR 
INCL_GPITRANSFORMS equ 1 ;0r use INCL.GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of elements 

PUSH® OTHER mat If Array ; Transform matrix 

CALL Gpi Query Vi ewi ngT ransf ormMatri x 

Returns WORD f Success ; Success indicator 


GpiQueryWidthTable 

EXTRN GpiQueryWidthTable: FAR 

INCLJ3PILCIDS equ 1 ;0r use INCLJ3PI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD IFirstChar 

PUSH DWORD 1 Count 

PUSH@ OTHER alData 

CALL GpiQueryWidthTable 


; Presentation-space handle 
;Codepoint of first character 
; Count of elements in Data 
;Array of width values 


Returns WORD f Success ; Success indicator 


GpiRealizeColorTable 

EXTRN GpiRealizeColorTable: FAR 

INCL_GPILOGCOLORTABLE equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiRealizeColorTable 

Returns WORD f Success ; Success indicator 
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GpiRectinRegion 

EXTRN GpiRectinRegion: FAR 

INCL_GPIREGIONS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgn ; Region handle 

PUSH0 OTHER rclRect ;Test rectangle 

CALL GpiRectinRegion 

Returns DWORD llnside ;Inside/error indicator 


GpiRectVisible 

EXTRN GpiRectVisible: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER rcl Rectangle ;Test rectangle, in world coordinates 

CALL GpiRectVisible 

Returns DWORD lVisibility Visibility indicator 


GpiRemoveDynamics 

EXTRN GpiRemoveDynamics: FAR 

I NCLJ5PI SEGMENTS equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lFirstSegid ; First segment in the section 
PUSH DWORD lLastSegid ;Last segment in the section 
CALL GpiRemoveDynamics 

Returns WORD f Success ; Success indicator 


GpiResetBoundaryData 

EXTRN GpiResetBoundaryData: FAR 

I NCL_GP I CORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

CALL GpiResetBoundaryData 

Returns WORD f Success ; Success indicator 


GpiResetPS 

EXTRN GpiResetPS: FAR 

INCL_GPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD fl Options ; Reset option 

CALL GpiResetPS 

Returns WORD f Success ; Success indicator 


GpiRestorePS 

EXTRN GpiRestorePS: FAR 

I NCLJ3PI CONTROL equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IPSid ; Identifier of the saved presentation space that is to be restored 

CALL GpiRestorePS 

Returns WORD fSuccess ; Success indicator 
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Gpi Rotate 

EXTRN Gpi Rotate: FAR 

INCl_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH DWORD hps 

PUSH® OTHER matl fArray 

PUSH DWORD 1 Options 

PUSH DWORD fxAngle 

PUSH!? OTHER ptl Center 

CALL Gpi Rotate 


; Presentation-space handle 
;Transform matrix 
;Transform options 
; Rotation angle 
; Center of rotation 


Returns WORD fSuccess ; Success indicator 


GpiSaveMetaFile 

EXTRN GpiSaveMetaFile: FAR 

INCLJ3PIMETAFILES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hmf ;Metafile handle 

PUSH© ASCIIZ szFilename filename 
CALL GpiSaveMetaFile 

Returns WORD fSuccess ; Success indicator 


GpiSavePS 

EXTRN GpiSavePS: FAR 

INCL_GPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiSavePS 

Returns DWORD IPSid ; Identifier of saved presentation space 


GpiScale 

EXTRN Gpi Scale: FAR 
INCL_GPITRANSFORMS equ 1 

PUSH DWORD hps 

PUSH© OTHER matl fArray 

PUSH DWORD 1 Options 

PUSH© OTHER afxScale 

PUSH© OTHER ptl Center 

CALL GpiScale 

Returns WORD fSuccess 


;0r use INCLJ5PI or INCL_PM 

; Presentation-space handle 
; Transform matrix 
; Transform options 
; Scale factors 
; Center of scale 

; Success indicator 


GpiSetArcParams 

EXTRN GpiSetArcParams: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH© OTHER arcpArcParams ;Arc parameters 

CALL GpiSetArcParams 

Returns WORD fSuccess ; Success indicator 


GpiSetAttrMode 

EXTRN GpiSetAttrMode: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMode ; Attribute mode 

CALL GpiSetAttrMode 

Returns WORD fSuccess ; Success indicator 
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GpiSetAttrs 

EXTRN GpiSetAttrs: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL PM 


PUSH 

DWORD 

hps 

PUSH 

DWORD 

IPrimType 

PUSH 

DWORD 

flAttrMask 

PUSH 

DWORD 

flDefMask 

PUSH® 

OTHER 

pbunAttrs 

CALL GpiSetAttrs 


; Presentation-space handle 
; Primitive type 
; Attributes mask 
;Defaults mask 
; Attributes 


Returns WORD f Success ; Success indicator 


GpiSetBackColor 

EXTRN GpiSetBackColor: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Col or ; Background color 

CALL GpiSetBackColor 

Returns WORD f Success ; Success indicator 


GpiSetBackMix 

EXTRN GpiSetBackMix: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMixMode ; Background-mix mode 

CALL GpiSetBackMix 

Returns WORD fSuccess ; Success indicator 


GpiSetBitmap 

EXTRN GpiSetBitmap: FAR 

INCL_GPIBITMAP$ equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hbm ; Handle of the bit map to be set 

CALL GpiSetBitmap 

Returns DWORD hbmOld ;01d bit-map handle 


GpiSetBitmapBits 

EXTRN GpiSetBitmapBits: FAR 

I NCLJ3PI BITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 


PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

IScanStart 

;Line number 

PUSH 

DWORD 

1 Scans 

; Number of scan lines to be transmitted 

PUSH® 

OTHER 

bBuffer 

; Bit-map data buffer 

PUSH® 

OTHER 

bmilnfoTable 

;Bit-map information table 


CALL GpiSetBitmapBits 

Returns DWORD IScansSet ; Number of scan lines actually set 

GpiSetBitmapDimension 

EXTRN GpiSetBitmapDimension: FAR 

INCL_GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hbm ;Bit-map handle 

PUSH® OTHER sizlBitmapDimension ; Width and height of bit map 

CALL GpiSetBitmapDimension 

Returns WORD fSuccess ; Success indicator 
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GpiSetBitmapId 

EXTRN GpiSetBitmapId: FAR 

I NCLJ5PI BITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hbm ; Bit-map handle 

PUSH DWORD ILcid ; Local identifier with which the bit map is to be tagged 
CALL GpiSetBitmapId 

Returns WORD f Success ; Success indicator 


GpiSetCharAngle 

EXTRN GpiSetCharAngle: FAR 

INCLJ3PI PRIMITIVES equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER gradl Angle ; Baseline angle 

CALL GpiSetCharAngle 

Returns WORD fSuccess ;Success indicator 


GpiSetCharBox 

EXTRN GpiSetCharBox: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER sizfxBox ;Character-box size in world coordinates 

CALL GpiSetCharBox 

Returns WORD fSuccess ; Success indicator 


GpiSetCharDirection 

EXTRN GpiSetCharDirection: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Direction ; Character direction 
CALL GpiSetCharDirection 

Returns WORD fSuccess ; Success indicator 


GpiSetCharMode 

EXTRN GpiSetCharMode: FAR 

INCL.GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMode ; Character mode 

CALL GpiSetCharMode 

Returns WORD fSuccess ; Success indicator 


GpiSetCharSet 

EXTRN GpiSetCharSet: FAR 

INCL_GPIPRIMITIVES equ 1 ;Or use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD llcid ; Character-set local identifier 

CALL GpiSetCharSet 

Returns WORD fSuccess ; Success indicator 
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GpiSetCharShear 

EXTRN Gpi SetCharShear : FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL.GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH0 OTHER ptl Angle Character shear vector 

CALL GpiSetCharShear 

Returns WORD f Success ; Success indicator 


GpiSetClipPath 

EXTRN GpiSetClipPath: FAR 

INCLJ3PIPATHS equ 1 ;Or use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IPath ;Path control flag 

PUSH DWORD 1 Options ; Options 

CALL GpiSetClipPath 

Returns WORD f Success ; Success indicator 


GpiSetClipRegion 

EXTRN GpiSetClipRegion: FAR 

INCL GPIREGIONS equ 1 ;0r use INCL GPI or INCL_PM 


PUSH DWORD hps 

PUSH DWORD hrgn 

PUSHO DWORD hrgnOld 

CALL GpiSetClipRegion 


; Presentation-space handle 

; Region handle 

;01d region handle (if any) 


Returns DWORD 1 Complexity ; Complexity of clipping/error indicator 


GpiSetColor 

EXTRN GpiSetColor: FAR 

INCL_GPIPRIMITIVES equ 1 ;Or use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Col or ; Col or 

CALL GpiSetColor 

Returns WORD f Success ; Success indicator 


GpiSetCp 

EXTRN GpiSetCp: FAR 

INCL_GPILCIDS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH WORD usCodePage ; Code-page id 

CALL GpiSetCp 

Returns WORD f Success ; Success indicator 


GpiSetCurrentPosition 

EXTRN GpiSetCurrentPosition: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH0 OTHER ptl Point ;New value of current position 

CALL GpiSetCurrentPosition 

Returns WORD f Success ; Success indicator 
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GpiSetDefArcParams 

EXTRN GpiSetDefArcParams: FAR 

INCLJ3PIDEFAULTS equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH0 OTHER arcpArcParams ; Default arc parameters 
CALL Gpi SetDef ArcParams 

Returns WORD f Success ; Success indicator 


GpiSetDefAttrs 


EXTRN GpiSetDefAttrs: FAR 
INCL_GPIDEFAULTS equ 1 

;0r use INCL_GPI or 

INCL_PM 

PUSH 

DWORD 

hps 

; Presentation-space handle 

PUSH 

DWORD 

IPrimType 

; Primitive type 


PUSH 

DWORD 

flAttrMask 

; Attributes mask 


PUSHO 

OTHER 

pbunAttrs 

; Default attribute 

values 

CALL GpiSetDefAttrs 



Returns WORD 

fSuccess 

; Success indicator 



GpiSetDefauItViewMatrlx 

EXTRN Gpi SetDefaul tVi ewMatri x: FAR 
INCL_GPITRANSFORMS equ 1 ;Or use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of elements 

PUSH© OTHER matlf array ;Transformation matrix 

PUSH DWORD 1 Options ;Transform options 

CALL Gpi SetDefaul tVi ewMatri x 

Returns WORD f Success ; Success indicator 


GpiSetDefTag 

EXTRN GpiSetDefTag: FAR 

INCL_GPIDEFAULTS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ITag ; Default tag identifier 

CALL GpiSetDefTag 

Returns WORD f Success ; Success indicator 


GpiSetDefViewingLimits 

EXTRN GpiSetDefViewingLimits: FAR 

INCL_GPIDEFAULTS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER rcl Limits ;Default viewing limits 
CALL GpiSetDefViewingLimits 

Returns WORD f Success ; Success indicator 


GpiSetDrawControl 

EXTRN GpiSetDrawControl : FAR 

I NCL_GPI CONTROL equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Control ;Drawing control 

PUSH DWORD lValue ; Required value of the drawing control 

CALL GpiSetDrawControl 

Returns WORD f Success ; Success indicator 
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GpiSetDrawingMode 

EXTRN GpiSetDrawingMode: FAR 

INCLJSPICONTROL equ 1 ;0r use INCL_GPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMode ;Mode to be used for subsequent drawing calls 

CALL GpiSetDrawingMode 

Returns WORD f Success ; Success indicator 


GpiSetEditMode 

EXTRN GpiSetEditMode: FAR 

INCL_GPISEGEDITING equ 1 ;Or use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMode ;Edit mode 

CALL GpiSetEditMode 

Returns WORD f Success ; Success indicator 


GpiSetElementPoi nter 

EXTRN GpiSetElementPoi nter: FAR 

INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Element ;The element number required 

CALL GpiSetElementPoi nter 

Returns WORD f Success ; Success indicator 


GpiSetElementPointerAtLabel 

EXTRN GpiSetElementPointerAtLabel : FAR 
INCL_GPISEGEDITING equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Label Required label 

CALL GpiSetElementPointerAtLabel 

Returns WORD f Success ; Success indicator 


GpiSetGraphicsField 

EXTRN GpiSetGraphicsField: FAR 

INCL_GPITRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER rcl Field ;Graphics field 

CALL GpiSetGraphicsField 

Returns WORD fSuccess ;Success indicator 


GpiSetlnitialSegmentAttrs 

EXTRN Gpi Setlni ti al SegmentAttrs : FAR 
INCL_GPISEGMENTS equ 1 ;0r use INCL.GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lAttribute ;Segment attribute 

PUSH DWORD lValue ; Attribute value 

CALL GpiSetlnitialSegmentAttrs 

Returns WORD fSuccess ; Success indicator 
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GpiSetLineEnd 

EXTRN GpiSetLineEnd: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCLJaPI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 
PUSH DWORD ILineEnd ; Style of line end 
CALL GpiSetLineEnd 

Returns WORD f Success ; Success indicator 


GpiSetLineJoin 

EXTRN GpiSetLineJoin: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ILineJoin ;Style of line join 
CALL GpiSetLineJoin 

Returns WORD f Success ; Success indicator 


GpiSetLineType 

EXTRN GpiSetLineType: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ILineType ;Line types available 

CALL GpiSetLineType 

Returns WORD f Success ; Success indicator 


GpiSetLineWidth 

EXTRN GpiSetLineWidth: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCLJaPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD fxLineWidth ; Line-width multiplier 

CALL GpiSetLineWidth 

Returns WORD f Success ; Success indicator 


GpiSetLineWidthGeom 

EXTRN GpiSetLineWidthGeom: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCLJ>M 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ILineWidth ;Geometric line width 
CALL GpiSetLineWidthGeom 

Returns WORD f Success ; Success indicator 


GpiSetMarker 

EXTRN GpiSetMarker: FAR 

INCLJaPIPRIMITIVES equ 1 ;0r use INCLJaPI or INCLJ>M 

PUSH DWORD hps . ; Presentation-space handle 
PUSH DWORD 1 Symbol ;Marker symbol 
CALL GpiSetMarker 

Returns WORD f Success ; Success indicator 
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GpiSetMarkerBox 

EXTRN GpiSetMarkerBox: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER sizfxSize ;Size of marker box 

CALL GpiSetMarkerBox 

Returns WORD fSuccess ; Success indicator 


GpiSetMarkerSet 

EXTRN GpiSetMarkerSet: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ISet ;Marker-set local identifier 

CALL GpiSetMarkerSet 

Returns WORD fSuccess ; Success indicator 


GpiSetMetaFileBits 

EXTRN GpiSetMetaFileBits: FAR 

INCLJBPIMETAFILES equ 1 ;0r use INCL_GPI or INCLJ>M 

PUSH DWORD hmf ;Metafil e-memory handle 

PUSH DWORD 1 Offset ; Offset 

PUSH DWORD 1 Length ; Length of the metafile data 

PUSH@ OTHER bBuffer ;Metafile data buffer 

CALL GpiSetMetaFileBits 

Returns WORD fSuccess ; Success indicator 


GpiSetMix 

EXTRN GpiSetMix: FAR 

INCL_GPIPRIMITIVES equ 1 ;Or use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IMixMode ;Mix mode 

CALL GpiSetMix 

Returns WORD fSuccess ; Success indicator 


GpiSetModelTransformMatrix 

EXTRN Gpi SetModel TransformMatri x : FAR 
INCL_GPITRANSFORMS equ 1 ;0r use INCLJ2PI or INCL_PM 


PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ; Number of elements in matrix 

PUSHO OTHER matlfArray ; Trans format ion matrix 

PUSH DWORD 1 Options transform options 

CALL GpiSetModelTransformMatrix 


Returns WORD fSuccess ; Success indicator 


GpiSetPageViewport 

EXTRN GpiSetPageViewport: FAR 

INCLJSPITRANSFORMS equ 1 ;0r use INCLJ5PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER rcl Viewport ;Page viewport 

CALL GpiSetPageViewport 

Returns WORD fSuccess ;Succes$ indicator 
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GpiSetPattern 

EXTRN GpiSetPattern: FAR 

INCLJ2PIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 PatternSymbol ; Pattern symbol 

CALL GpiSetPattern 

Returns WORD f Success ; Success indicator 


GpiSetPatternRefPoint 

EXTRN GpiSetPatternRefPoint: FAR 

INCL_GPI PRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH0 OTHER ptlRefPoint ;Pattern reference point 
CALL GpiSetPatternRefPoint 

Returns WORD f Success ; Success indicator 


GpiSetPatternSet 

EXTRN GpiSetPatternSet: FAR 

INCL_GPIPRIMITIVES equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ISet ; Pattern-set local identifier 

CALL GpiSetPatternSet 

Returns WORD f Success ; Success indicator 


GpiSetPel 

EXTRN GpiSetPel: FAR 

INCL_GPIBITMAPS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER ptl Point ; Position in world coordinates 
CALL GpiSetPel 

Returns DWORD lHits ; Correlation/error indicator 


GpiSetPickAperturePosition 

EXTRN Gpi SetPi ckAperturePos i t i on : FAR 
INCL_GPICORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER ptl Pick ; Center of the pick aperture 

CALL GpiSetPickAperturePosition 

Returns WORD f Success ; Success indicator 


GpiSetPickApertureSize 

EXTRN GpiSetPickApertureSize: FAR 

I NCL_GPI CORRELATION equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Options ; Setting option 

PUSH@ OTHER si zl Size ;Pick aperture size 

CALL GpiSetPickApertureSize 

Returns WORD f Success ; Success indicator 
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GpiSetPS 

EXTRN GpiSetPS: FAR 

INCLJSPICONTROL equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER sizlsize ; Presentation-space size 

PUSH DWORD fl Options ;Options 

CALL GpiSetPS 

Returns WORD f Success ; Success indicator 


GpiSetRegion 

EXTRN GpiSetRegion: FAR 

INCLJSPIREGIQNS equ 1 ;Or use INCLJJPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD hrgn ; Region handle 

PUSH DWORD 1 count ; Count of rectangles 

PUSH® OTHER arcl Rectangles ; Array of rectangles 

CALL GpiSetRegion 

Returns WORD f Success ; Success indicator 


GpiSetSegmentAttrs 

EXTRN GpiSetSegmentAttrs: FAR 

1NCL_GPISEGMENTS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lSegid ; Segment identifier 

PUSH DWORD 1 Attribute ; Segment attribute 

PUSH DWORD lValue ; Attribute value 

CALL GpiSetSegmentAttrs 

Returns WORD f Success ; Success indicator 


GpiSetSegmentPriority 

EXTRN GpiSetSegmentPriority: FAR 

INCLJ2PISEGMENTS equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lSegid ; Segment identifier 

PUSH DWORD IRefSegid ; Reference segment identifier 

PUSH DWORD 1 Order ; Segment higher or lower 

CALL GpiSetSegmentPriority 

Returns WORD f Success ; Success indicator 

GpiSetSegmentTransformMatrix 

EXTRN Gpi SetSegmentT ransf ormMatri x : FAR 
INCLJ3PITRANSF0RMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lSegid ; Segment identifier 

PUSH DWORD 1 Count ; Number of elements 

PUSH® OTHER matlf array transformation matrix 

PUSH DWORD lOptions transform options 

CALL GpiSetSegmentTransformMatrix 

Returns WORD f Success ; Success indicator 
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GpiSetStopDraw 

EXTRN GpiSetStopDraw: FAR 

I NCL_G PI CONTROL equ 1 ;0r use INCLJ3PI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD lValue ;Stop draw condition 

CALL GpiSetStopDraw 

Returns WORD f Success ;Success indicator 


GpiSetTag 

EXTRN GpiSetTag: FAR 

I NCL_GP I CORRELATION equ 1 ;0r use INCLJ5PI or INCL.PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD ITag ;Tag identifier 

CALL GpiSetTag 

Returns WORD fSuccess ;Success indicator 


GpiSetViewingLimits 

EXTRN GpiSetViewingLimits: FAR 

INCL_GPITRANSFORMS equ 1 ;Or use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH© OTHER rcl Limits ; Viewing limits in model space 
CALL GpiSetViewingLimits 

Returns WORD fSuccess ; Success indicator 


GpiSetViewingTransformMatrix 

EXTRN Gpi SetVi ewi ngTransformMatri x : FAR 

INC L_GP TRANSFORMS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD 1 Count ;Number of elements 

PUSH© OTHER matlfArray Transformation matrix 
PUSH DWORD lOptions Transform option 

CALL GpiSetViewingTransformMatrix 

Returns WORD fSuccess ;Succe$s indicator 


GpiStrokePath 

EXTRN GpiStrokePath: FAR 

INCL_GPI PATHS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH DWORD IPath ; Identifier of path to be stroked; it must be 1 

PUSH DWORD f lOptions ; Stroke option 

CALL GpiStrokePath 

Returns DWORD lHits ; Correlation/error indicator 


GpiTranslate 

EXTRN GpiTranslate: FAR 
I N C L_G P I TRANS FORMS equ 1 

PUSH DWORD hps 

PUSH© OTHER matlfArray 

PUSH DWORD lOptions 

PUSH© OTHER ptlTranslati 

CALL GpiTranslate 

Returns WORD fSuccess 


;0r use INCL_GPI or INCL_PM 

; Presentation-space handle 
Transform matrix 
Transform options 
m Translation 

;Success indicator 
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GpillnloadFonts 

EXTRN Gpi Uni oadFonts : FAR 

INCL_GPILCIDS equ 1 ;0r use INCL_GPI or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCIIZ szFilename ; Fully qualified file name of the font resource 
CALL Gpi Uni oadFonts 

Returns WORD f Success ; Success indicator 


GpiUnrealizeColorTable 

EXTRN Gpi Unreal i zeCol orTabl e : FAR 

INCL_GPILOGCOLORTABLE equ 1 ;0r use INCL.GPI or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 
CALL GpiUnrealizeColorTable 

Returns WORD f Success ; Success indicator 


GpiWCBitBIt 

EXTRN GpiWCBitBIt: FAR 

INCL_GPIBITMAP$ equ 1 ;0r use INCLJ.PI or INCL_PM. Also in COMMON section 

PUSH DWORD hpsTarget ;Target presentation-space handle 

PUSH DWORD hbmSource ; Source bit-map handle 

PUSH DWORD 1 Count ; Point count 

PUSH® OTHER apt 1 Points ; Point array 

PUSH DWORD IRop ;Mixing function required 

PUSH DWORD fl Opt ions ; Opt ions 

CALL GpiWCBitBIt 

Returns DWORD lHits ; Correlation/error indicator 
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Chapter 5. Picture Function Calls 


Piclchg 

EXTRN Piclchg: FAR 

INCL_PIC equ 1 ;0r use INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCI IZ szSourceFileName ;The name of the source file 

PUSH® ASCIIZ szDestinationFileName ;The name of the destination file 

PUSH DWORD IType Specifies the type of conversion 

CALL Piclchg 

Returns WORD f Success ; Success indicator 


PicPrint 

EXTRN PicPrint: FAR 

INCL_PIC equ 1 ;0r use INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCIIZ szFilename ; Ful 1 path and filename of the source file 

PUSH DWORD IType ;Type of source file 

PUSH® ASCIIZ szParams ; Spooler parameters 

CALL PicPrint 

Returns WORD fSuccess ; Success indicator 
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Chapter 6. Profile Function Calls 


PrfAddProgram 

EXTRN PrfAddProgram: FAR 

INCLJrfINPROGRAMLIST equ 1 ;0r use INCL_WIM or INCL_PM 

PUSH DWORD hini ;Initializat ion-file handle 

PUSH® OTHER progdeDetails ; Program details for the program to be added to the program list 

PUSH DWORD hprogGroup ; Handle of the group to which the program is to be added 

CALL PrfAddProgram 

Returns DWORD hprog ; Program handle for the program added to the program list 


PrfChangeProgram 

EXTRN PrfChangeProgram: FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCL_WIN or INCLJ>M 

PUSH DWORD hini ; Initial ization-fi le handle 

PUSH DWORD hprog ;Handle of the program whose information is to be changed 

PUSH® OTHER Details ; Program details 

CALL PrfChangeProgram 

Returns WORD f Success ; Success indicator 


PrfCloseProfile 

EXTRN PrfCloseProfile: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Initialization-file handle 
CALL PrfCloseProfile 

Returns WORD f Success ;Success indicator 


PrfCreateGroup 

EXTRN PrfCreateGroup: FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Initialization-file handle 

PUSH® ASCIIZ szTitle ;Title of the new group 

PUSH WORD chVisibility Visibility control 

CALL PrfCreateGroup 

Returns DWORD hprogGroup ;Group handle for the newly-created group 


PrfDestroyGroup 

EXTRN PrfDestroyGroup : FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hini ; Initial ization-fi le handle 

PUSH DWORD hprogGroup ; Group handle 
CALL PrfDestroyGroup 

Returns WORD f Success ; Success indicator 
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PrfOpenProfile 

EXTRN PrfOpenProfile: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCIIZ szFileName ;User-profile file name 
CALL PrfOpenProfile 

Returns DWORD hini ; Ini ti al i zati on-f i 1 e handle 


PrfQueryDefinition 

EXTRN PrfQueryDefinition: FAR 

INCL_WINPRQGRAMLIST equ I ;0r use INCL_WIN or INCL_PM 
PUSH DWORD hini ; Ini ti al ization-fi le handle 

PUSH DWORD hprog ;Handle of the program whose details are to be returned 

PUSH® OTHER Details ; Program details 

PUSH DWORD cchBufferMax ; Maxi mum length in bytes 

CALL PrfQueryDefinition 

Returns DWORD ul Length ; Length of returned data 


PrfQueryProfile 

EXTRN Prf QueryProf i 1 e : FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ;Anchor-block handle 

PUSH® OTHER prfproProfile ; Profile names structure 
CALL PrfQueryProfile 

Returns WORD f Success ; Success indicator 


Prf QueryProf ileData 

EXTRN PrfQueryProf i 1 eData 
INCL_WINSHELLDATA equ 1 

PUSH DWORD hini 
PUSH® ASCIIZ szApp 
PUSH® ASCIIZ szKey 
PUSH® OTHER Buffer 
PUSH® DWORD ulBufferMax 
CALL PrfQueryProf i 1 eData 

Returns WORD fSuccess 


FAR 

;0r use INCL_WIN or INCL_PM 

; Initialization-file handle 
Application name 
;Key name 
; Value data 
; Si ze of value data 

; Success indicator 


PrfQueryProfilelnt 

EXTRN PrfQueryProfilelnt: FAR 

INCL.WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Initial ization-fi le handle 
PUSH® ASCIIZ szApp Application name 

PUSH® ASCIIZ szKey ;Key name 

PUSH WORD sDefault ; Default value 
CALL PrfQueryProfilelnt 

Returns WORD sResult ;Key value specified in the intialization file 
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PrfQueryProfileSize 

EXTRN PrfQuery Prof i 1 eSi ze : FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Initial izati on-file handle 

PUSH© ASCI IZ szApp ;Appli cation name 

PUSH© ASCIIZ szKey ;Key name 

PUSH© DWORD DataLen ;Data length 

CALL PrfQueryProfileSize 

Returns WORD f Success ; Success indicator 


PrfQueryProfileString 

EXTRN PrfQueryProfileString: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCLJ/IN or INCL_PM 


PUSH DWORD hini 
PUSH© ASCIIZ szApp 
PUSH© ASCIIZ szKey 
PUSH© ASCIIZ szDefault 
PUSH© OTHER Buffer 


;Initialization-file handle 
;Appli cation name 
;Key name 
; Default string 
;Profile string 


PUSH DWORD cchBufferMax ;Maximum string length 
CALL PrfQueryProfileString 


Returns DWORD pul Length ; String length returned 


PrfQueryProgramCategory 

EXTRN PrfQueryProgramCategory: FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hini ; Initial izati on-file handle 

PUSH© ASCIIZ szExe ;Executable-fi le name 

CALL PrfQueryProgramCategory 

Returns WORD Category ; Program category 


PrfQueryProgramHandle 

EXTRN PrfQueryProgramHandle: FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Initial izati on-fi le handle 

PUSH© ASCIIZ szExe ;Executable-file name 

PUSH© OTHER hprogArray ; Program handles 

PUSH DWORD cchBufferMax ;Maximum number of program handles 

PUSH© DWORD ul Count ; Number of program handles returned 

CALL PrfQueryProgramHandle 

Returns DWORD ul Length ; Number of bytes returned 


PrfQueryProgramTitles 

EXTRN PrfQueryProgramT i tl es : FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD 
PUSH DWORD 


hini ;Initialization-file handle 

hprogGroup ; Handle of the program or group whose information is to be 
returned 


PUSH© OTHER Titles ; Program information buffer 

PUSH DWORD cchBufferMax ; Buffer length 

PUSH© DWORD ul Count ; Number of structures returned 

CALL PrfQueryProgramTitles 


Returns DWORD ul Length ; Length returned 
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PrfRemoveProgram 

EXTRN PrfRemoveProgram: FAR 

INCLWINPROGRAMLIST equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hini ; Ini ti al izati on-file handle 

PUSH DWORD hprog ; Program handle 

CALL PrfRemoveProgram 

Returns WORD f Success ; Success indicator 


PrfReset 

EXTRN PrfReset: FAR 

INCLJ/INSHELLDATA equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER prfproProfile ; Profile-names structure 

CALL PrfReset 

Returns WORD f Success ; Success indicator 


PrfWriteProfileData 

EXTRN PrfWriteProfileData: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Ini ti al ization-file handle 

PUSH® ASCIIZ szApp Application name 

PUSH® ASCIIZ szKey ;Key name 

PUSH® OTHER Data ; Value data 

PUSH DWORD cchDataLen ;Size of value data 

CALL PrfWriteProfileData 

Returns WORD f Success ;Success indicator 


PrfWriteProfileString 

EXTRN PrfWriteProfileString: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hini ; Initial ization-file handle 

PUSH® ASCIIZ szApp Application name 

PUSH® ASCIIZ szKey ;Key name 

PUSH® ASCIIZ szData ;Text string 

CALL PrfWriteProfileString 

Returns WORD f Success ; Success indicator 
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Chapter 7. Spooler Function Calls 


SpIQmAbort 

EXTRN SpIQmAbort: FAR 

INCL_SPL equ 1 ;0r use INCL_PM 

PUSH DWORD hspl Spooler handle 
CALL SpIQmAbort 

Returns WORD f Success ; Success indicator 


SpIQmClose 

EXTRN SpIQmClose: FAR 

INCL_SPL equ 1 ;0r use INCL_PM 

PUSH DWORD hspl ; Spooler handle 

CALL SpIQmClose 

Returns WORD f Success ; Success indicator 


SpIQmEndDoc 

EXTRN SpIQmEndDoc: FAR 
INCLJPL equ 1 ;0r use INCL_PM 

PUSH DWORD hspl Spooler handle 
CALL SpIQmEndDoc 

Returns WORD usJob ;Job identifier 


SpIQmOpen 

EXTRN SpIQmOpen: FAR 

INCL_SPL equ 1 ;0r use INCL_PM 

PUSHO ASCI IZ szToken ;A token (nickname) that identifies spooler information 

PUSH DWORD 1 Count ; Number of items 

PUSH@ OTHER qmdopData ;0pen parameters 

CALL SpIQmOpen 

Returns DWORD hspl ; Spooler handle 


SpIQmStartDoc 

EXTRN SpIQmStartDoc: FAR 
INCL.SPL equ 1 ;0r use INCL_PM 

PUSH DWORD hspl ; Spooler handle 
PUSH® ASCIIZ szDocName document name 
CALL SpIQmStartDoc 

Returns WORD fSuccess ; Success indicator 


SpIQmWrite 

EXTRN SpIQmWrite: FAR 

INCLJPL equ 1 ;0r use INCL_PM 

PUSH DWORD hspl ; Spooler handle 

PUSH DWORD 1 Count ; Length in bytes 

PUSH® OTHER bData ;Buffer of data to be written to the spool file 

CALL SpIQmWrite 

Returns WORD fSuccess ; Success indicator 
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SpIQpInstall 

EXTRN SpIQpInstall: FAR 
INCL_SPL equ 1 ;0r use INCL_PM 

PUSH DWORD hwnd ; Window handle 

CALL SpIQpInstall 

Returns WORD f Success ; Success indicator 


SpIQpQueryDt 

EXTRN SpIQpQueryDt: FAR 
INCL_SPL equ 1 ;Or use INCl_PM 

PUSH@ DWORD 1 Count ; Maxi mum number of data types that can be returned 

PUSHO ASCIIZ aszDatatypes ;An array containing the data types supported 
CALL SpIQpQueryDt 

Returns WORD f Success ; Success indicator 
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Chapter 8. Video Function Calls 


VioAssociate 

EXTRN VioAssociate: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH DWORD hdc ; Device-context handle 

PUSH WORD hvps ;VI0 presentation-space handle 

CALL VioAssociate 

Returns WORD usError ; Error indicator 


VioCreateLogFont 

EXTRN VioCreateLogFont: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 


PUSH? OTHER 

fatattrs 

; Attributes of font 

PUSH DWORD 

llcid 

; Local identifier 

PUSH? OTHER 

Name 

; Logical -font name 

PUSH WORD 

hvps 

; VIO presentation-space handle 

CALL VioCreateLogFont 


Returns WORD 

usError 

; Error indicator 

VioCreatePS 




EXTRN VioCreatePS:FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 


PUSH@ 

WORD 

hvps 

; VIO presentation-space handle 

PUSH 

WORD 

sdepth 

; Presentation-space depth 

PUSH 

WORD 

swidth 

; Presentation-space width 

PUSH 

WORD 

sFormat 

; Presentation-space format 

PUSH 

WORD 

sAttrs 

attribute bytes per character 

PUSH 

WORD 

hvpsReserved 

; Reserved (must be zero) 


CALL VioCreatePS 

Returns WORD usError ; Error indicator 


VioDeleteSetld 

EXTRN VioDeleteSetld: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH DWORD llcid ; Local identifier 

PUSH WORD hvps ;VI0 presentation-space handle 

CALL VioDeleteSetld 

Returns WORD usError ; Error indicator 


VioDestroyPS 

EXTRN VioDestroyPS: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH WORD hvps ; VIO presentation-space handle 
CALL VioDestroyPS 

Returns WORD usError ; Error indicator 
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VioGetDeviceCellSize 

EXTRN VioGetDeviceCellSize: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH? WORD sHeight ; Current device cell height in pels 

PUSH? WORD sWidth ; Current device cell width in pels 

PUSH WORD hvps ; VIO presentation-space handle 

CALL VioGetDeviceCellSize 

Returns WORD usError ; Error indicator 


VioGetOrg 

EXTRN VioGetOrg: FAR 

INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH? WORD sRow ;Row number 

PUSH? WORD sColumn ; Column number 

PUSH WORD hvps ;VI0 presentation-space handle 

CALL VioGetOrg 

Returns WORD usError ; Error indicator 


VioQueryFonts 

EXTRN VioQueryFonts: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 


PUSH? 

PUSH? 

PUSH 

PUSH? 

PUSH? 

PUSH 

PUSH 


DWORD 

OTHER 

DWORD 

DWORD 

ASCI IZ 

DWORD 

WORD 


1 Remfonts 
afmMetri cs 
IMetricsLength 
1 Fonts 
szFacename 
fl Options 
hvps 


CALL VioQueryFonts 
Returns WORD usError 


; Number of fonts for which information is not returned 
;Font metrics 

;The length of each metrics record to be returned 
; Number of fonts 

;Facename of the fonts of interest 
; Enumeration options 
; VIO presentation-space handle 

; Error indicator 


VioQuerySetlds 

EXTRN VioQuerySetlds: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 


PUSH? 

OTHER 

allcids 

; Local identifiers 

PUSH? 

OTHER 

Names 

;Font names 

PUSH? 

OTHER 

al Types 

; Object types 

PUSH 

DWORD 

1 count 

;The number of objects to be queried 

PUSH 

WORD 

hvps 

; VIO presentation-space handle 

CALL VioQuerySetlds 


Returns WORD 

usError 

; Error indicator 


VioSetDeviceCellSize 

EXTRN Vi oSetDevi ceCel 1 Size: FAR 
INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH WORD sHeight ;The required device cell height in pels 

PUSH WORD sWidth ;The required device cell width in pels 

PUSH WORD hvps ;VIO presentation space handle 

CALL VioSetDeviceCellSize 

Returns WORD usError ; Error indicator 
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VioSetOrg 

EXTRN VioSetOrg: FAR 

INCL_AVI0 equ 1 ;0r use INCL.PM 

PUSH WORD sRow ;Row number 

PUSH WORD sColumn jColumn number 

PUSH WORD hvps ; VIO presentation-space handle 

CALL VioSetOrg 

Returns WORD usError ; Error indicator 


VioShowPS 

EXTRN VioShowPS: FAR 

INCL_AVI0 equ 1 ;0r use INCL_PM 

PUSH WORD sDepth ;The depth of the rectangle in character cell units 

PUSH WORD sWidth ;The width of the rectangle in character cell units 

PUSH WORD soffCel 1 ;Cell offset 

PUSH WORD hvps ; VIO presentation-space handle 

CALL VioShowPS 

Returns WORD usError ; Error indicator 
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Chapter 9. Window Function Calls 


WinAddAtom 

EXTRN WinAddAtom: FAR 

INCL.WINATOM equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hatomtblAtomTbl ; Atom- table handle 
PUSH® ASCIIZ szAtomName ;Atom name 

CALL WinAddAtom 

Returns WORD atom ;Atom value 


WinAddProgram 

EXTRN WinAddProgram: FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD hab ;Anchor-block handle 

PUSH® OTHER pibProgramlnfo ; Program information for the program to be added to the 

installed program list 

PUSH DWORD hprogGroupHandle ;Handle of the program group to which the program is to be 

added 


CALL WinAddProgram 


Returns DWORD hprogProgHandle ; Program handle for the program added to the installed 

program list 


WinAddSwitchEntry 

EXTRN WinAddSwitchEntry: FAR 

INCL_WINSWITCHLIST equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH® OTHER swctlSwitchData ;Switch data 
CALL WinAddSwitchEntry 

Returns DWORD hswitchSwitch ; Handle to the newly-created switch list entry 


WinAlarm 

EXTRN WinAlarm: FAR 

INCLJtfINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDeskTop ;Desktop-window handle 
PUSH WORD fsStyle ; Alarm style 
CALL WinAlarm 

Returns WORD f Result ; Alarm-generated indicator 


WinAllocMem 

EXTRN WinAllocMem: FAR 

INCL_WINHEAP equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hheapHeap ;Heap handle 

PUSH WORD uscb ;Total number of bytes to allocate 

CALL WinAllocMem 

Returns WORD npbMem ; Memory pointer 
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WinAvailMem 

EXTRN WinAvailMem: FAR 

INCL_WINHEAP equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hheapHeap ;Heap handle 

PUSH WORD f Compact ; Compact Indicator 

PUSH WORD cb ; Reserved 

CALL WinAvailMem 

Returns WORD usLargest ;Size of the largest memory block available 


WinBeginEnumWindows 

EXTRN Wi nBegi nEnumWi ndows : FAR 

INCLWINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndParent ;Handle of the window whose child windows are to be enumerated 
CALL WinBeginEnumWindows 

Returns DWORD Henum ^numeration handle 


WinBeginPaint 

EXTRN WinBeginPaint: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCLJrfIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Handle of window where drawing is going to occur 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER rclRect ; Bounding rectangle 

CALL WinBeginPaint 

Returns DWORD hpsPaintPS ; Presentation-space handle 


WinBroadcastMsg 

EXTRN Wi nBroadcastMsg : FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCLJJIN or INCL_PM 


PUSH DWORD hwndParent 

PUSH WORD usMsgld 

PUSH DWORD mpParaml 

PUSH DWORD mpParam2 

PUSH WORD fsCmd 

CALL WinBroadcastMsg 


; Parent-window handle 
;Message identifier 
; Parameter 1 
; Parameter 2 

; Broadcast message conmand 


Returns WORD f Success ; Success indicator 


WinCalcFrameRect 

EXTRN WinCalcFrameRect: FAR 

INCL_WINFRAMEMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hwnd ; Frame-window handle 

PUSH@ OTHER rclRect ; Window rectangle 

PUSH WORD f Frame ; Frame indicator 

CALL WinCalcFrameRect 

Returns WORD f Success ; Rectangle-calculated indicator 


WinCallMsgFilter 

EXTRN WinCallMsgFilter: FAR 

INCLWINHOOKS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH0 OTHER qmsgpqmsg ;Message to be passed to the message-filter hook 
PUSH WORD usFilter ; Filter 

CALL WinCallMsgFilter 

Returns WORD fHookRet ;Message-filter hook return indicator 
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WinCancelShutdown 

EXTRN WinCancelShutdown: FAR 

I NC L_WI NMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hmq ; Queue handle 

PUSH WORD f Cancel Always ;Cancellation control 

CALL WinCancelShutdown 

Returns WORD f Success ; Success indicator 


WinCatch 

EXTRN WinCatch: FAR 

I NC L J4I N CAT CHTH ROW equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH® OTHER ctchbfCatchBuf ; Saved execution environment buffer 
CALL WinCatch 

Returns WORD sRetCode ; Return code 


WinChangeSwitchEntry 

EXTRN WinChangeSwitchEntry: FAR 

INCL_WINSWITCHLIST equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hswitchSwitch ; Handle to the switch-list entry to be changed 
PUSH® OTHER swctl Swi tchData ; Switch-control data 

CALL WinChangeSwitchEntry 

Returns WORD usRetCode ; Return code 


WinCloseClipbrd 

EXTRN WinCloseClipbrd: FAR 

INCLJIINCLIPBOARD equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

CALL WinCloseClipbrd 

Returns WORD f Success ; Success indicator 


WinCompareStrings 

EXTRN Wi nCompareStri ngs : FAR 
INCL_WINCOUNTRY equ 1 ;0r 

PUSH DWORD hab 
PUSH WORD idCodepage 
PUSH WORD idCountryCode 
PUSH® ASCI IZ szStringl 
PUSH® ASCI IZ szString2 
PUSH WORD fsOptions 
CALL WinCompareStrings 

Returns WORD usResult 


WinCopy Accel Table 

EXTRN WinCopyAccel Table: FAR 
INCL_WINACCELERATORS equ 1 

PUSH DWORD hAccel 

PUSH® OTHER acctAccelTabl 

PUSH WORD usCopyMax 

CALL WinCopyAccel Table 

Returns WORD usCopied 


use INCL_WIN or INCLJM 

; Anchor-block handle 

; Codepage identity of both strings 

; Country code 

; String 1 

; String 2 

Reserved 

; Comparison result 


;0r use INCLJIIN or INCL_PM 

;Accelerator-table handle 
;Accelerator-table data area 
;Maximum data area size 

; Amount copied or size required 
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WinCopyRect 

EXTRN WinCopyRect: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER rclDest ; Destination rectangle 

PUSH® OTHER rclSrc ; Source rectangle 

CALL WinCopyRect 

Returns WORD fSuccess ;Success indicator 


WinCpTranslateChar 

EXTRN WinCpTranslateChar: FAR 

INCL_WINCOUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD idCpSource ; Source-character code page 

PUSH WORD ucSource ; Character to be translated 

PUSH WORD idCpDest ;Code page of the resultant character 

CALL WinCpTranslateChar 

Returns WORD ucDest ;If nonzero, the translated character 


WinCpTranslateString 

EXTRN WinCpTranslateString: FAR 

INCL_WINCOUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD idCpSource ; Source-string code page 

PUSH® ASCI IZ szSource ; String to be translated 

PUSH WORD idCpDest ;Code page of the resultant string 

PUSH WORD cbLenDest ;Maximum length of output string 

PUSH® ASCIIZ szDest ;The translated string 

CALL WinCpTranslateString 

Returns WORD fSuccess ; Success indicator 


WinCreateAccelTable 

EXTRN WinCreateAccelTable: FAR 

INCL_WINACCELERATORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER acctAccel Table ; Accelerator table 
CALL WinCreateAccelTable 

Returns DWORD hAccel ;Accelerator-table handle 


WinCreateAtomTable 

EXTRN WinCreateAtomTable: FAR 

INCUMNATOM equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH WORD uslnitial ; Initial bytes 

PUSH WORD usBuckets ;Size of the hash table 

CALL WinCreateAtomTable 

Returns DWORD hatomtblAtomTbl ; Atom- table handle 
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WinCreateCursor 

EXTRN WinCreateCursor: FAR 

INCL_WINCURSORS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Handle of window in which cursor is displayed 

PUSH WORD sx ;x position of cursor 

PUSH WORD sy ;y position of cursor 

PUSH WORD sex ;x size of cursor 

PUSH WORD scy ;y size of cursor 

PUSH WORD usrgf ; Controls the appearance of the cursor 

PUSH? OTHER rcl Clip ; Cursor rectangle 

CALL WinCreateCursor 

Returns WORD f Success ; Success indicator 


WinCreateDIg 

EXTRN WinCreateDIg: FAR 

INCL.WINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndParent ; Parent-wi ndow handle of the created dialog window 

PUSH DWORD hwndOwner ; Requested owner-window handle of the created dialog window 

PUSH? OTHER DlgProc ;Dialog procedure for the created dialog window 

PUSH? OTHER dlgtDlgTmp ; Dialog template 

PUSH? OTHER CreateParams ; Appl i cation-defined data area 

CALL WinCreateDIg 

Returns DWORD hwndDlg ; Dialog-window handle 

WinCreateFrameControls 

EXTRN WinCreateFrameControls: FAR 

INCLJ/INFRAMEMGR equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hwndFrame ; Frame-window handle 

PUSH? OTHER Fcdata ; Frame-control data 

PUSH? ASCIIZ szTitle ;Title string 

CALL WinCreateFrameControls 

Returns WORD f Success ; Success indicator 


WinCreateGroup 

EXTRN WinCreateGroup: FAR 

INC L_W I N PROGRAML I ST equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH? ASCIIZ szTitle ;Ti tl e of the new group 

PUSH WORD ucVisibility ; Visibility control 

PUSH DWORD flresl Reserved 

PUSH DWORD f 1 res2 Reserved 

CALL WinCreateGroup 

Returns DWORD hprogGroupHandle ; Program-group handle for the newly-created group 
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WinCreateHeap 

EXTRN WinCreateHeap: FAR 

INCL WINHEAP equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH 

WORD 

usHeapBase 

; Selector of the segment to contain the local heap 

PUSH 

WORD 

usHeapSize 

; Initial heap size in bytes 

PUSH 

WORD 

usGrow 

;Heap growth size in bytes 

PUSH 

WORD 

usMi nDed 

; Mini mum element size 

PUSH 

WORD 

usMaxDed 

; Maxi mum element size 

PUSH 

WORD 

fsOptions 

; Optional characteristics 


CALL WinCreateHeap 

Returns DWORD hHeap ;Heap handle 

WinCreateMenu 

EXTRN WinCreateMenu: FAR 

INCLJtflNMENUS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndOwner ;0wner- and parent-window handle of the created menu window 
PUSH® OTHER mtMenutmp ;Menu template in binary format 
CALL WinCreateMenu 

Returns DWORD hwndMenu ;Menu-window handle 

WinCreateMsgQueue 

EXTRN WinCreateMsgQueue: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD sQueuesize ;Maximum queue size 
CALL WinCreateMsgQueue 

Returns DWORD hmq ;Message-queue handle 


WinCreatePointer 

EXTRN WinCreatePointer: FAR 

INCL.WINPOINTERS equ 1 ;0r use INCLJIIN or INCLJ>M 


PUSH 

DWORD 

hwndDeskTop 

; Desktop-window handle or HWND_DESKTOP 

PUSH 

DWORD 

hbmBi tMap 

; Bit-map handle from which the pointer image is created 

PUSH 

WORD 

fPointerSize 

; Pointer-size indicator 

PUSH 

WORD 

sxHotspot 

;x offset of hotspot within pointer from its lower left corner (in 




pels) 

PUSH 

WORD 

syHotspot 

;y offset of hotspot within pointer from its lower left corner (in 




pels) 

CALL WinCreatePointer 


Returns DWORD hptr 

; Pointer handle 


WinCreatePointerlndirect 

EXTRN Wi nCreatePoi nterlndi rect : FAR 
I NCL_WIN POINTERS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle or HWND_DESKTOP 

PUSH® OTHER ptriPointerlnfo ; Pointer information structure 
CALL WinCreatePointerlndirect 

Returns DWORD hptr ; Pointer handle 
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WinCreateStdWindow 

EXTRN Wi nCreateStdWi ndow: FAR 
INCL_WINFRAMEMGR equ 1 ;0r use 


INCL WIN or INCL PM. Also in COMMON section 


PUSH 

DWORD 

hwndParent 

; Parent -window handle 

PUSH 

DWORD 

fl Style 

; Frame-window style 

PUSH© 

DWORD 

flCreateFlags ; Frame-creation flags 

PUSH© 

ASCIIZ 

szClassClient ; Client-window class name 

PUSH© 

ASCIIZ 

szTitle 

;Ti tie-bar text 

PUSH 

DWORD 

flStyleClient ; Client-window style 

PUSH 

WORD 

Resource 

; Resource identifier 

PUSH 

WORD 

Id 

; Frame-window identifier 

PUSH© 

DWORD 

hwndClient 

; Client-window handle 

CALL WinCreateStdWindow 


Returns DWORD 

hwndFrame 

; Frame-window handle 

Wi nCreateS witch Entry 


EXTRN WinCreateSwitchEntry:FAR 

INCL_WINSWITCHLIST equ 1 

;0r use INCL_WIN or INCL_PM 

PUSH 

DWORD 

hab 

; Anchor-block handle 

PUSH® 

OTHER 

swctlSwitchData ; Switch data 

CALL WinCreateSwitchEntry 


Returns DWORD 

hswitchSwitch ;Handle to the newly-created switch 

WinCreateWindow 


EXTRN WinCreateWindow: FAR 
INCLWINWINDOWMGR equ 1 ; 

Or use INCLJIIN or INCL.PM 

PUSH 

DWORD 

hwndParent 

Parent-window handle 

PUSH© 

ASCIIZ 

szClassName 

Registered-class name 

PUSH© 

ASCIIZ 

szName 

Window text 

PUSH 

DWORD 

fl Style 

Window style 

PUSH 

WORD 

sxcoord 

x coordinate of window position 

PUSH 

WORD 

sycoord 

y coordinate of window position 

PUSH 

WORD 

sWidth 

Width of window, in window coordinates 

PUSH 

WORD 

sHeight 

Height of window, in window coordinates 

PUSH 

DWORD 

hwndOwner 

Owner-window handle 

PUSH 

DWORD 

hwndBehind 

Sibling-window handle 

PUSH 

WORD 

Id 

Window identifier 

PUSH© 

OTHER 

CtlData 

Control data 

PUSH© 

OTHER 

PresParams 

Presentation parameters 


CALL Wi nCreateWi ndow 
Returns DWORD hwnd 


;Window handle 


WinDdelnitiate 

EXTRN WinDdelnitiate: FAR 

INCL.WINDDE equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hwndClient ; Client's window handle 
PUSH® ASCIIZ szAppName ;Application name 
PUSH© ASCIIZ szTopicName ;Topic name 
CALL WinDdelnitiate 

Returns WORD f Success ; Success indicator 
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WinDdePostMsg 

EXTRN WinDdePostMsg: FAR 

INCL_WINDDE equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH WORD 
PUSH0 OTHER 
PUSH WORD 


hwndTo ; Window handle of target 
hwndFrom ; Window handle of originator 
usMsgld ;Message identifier 
ddeData ;DDE structure 
fRetry ; Retry indicator 


CALL WinDdePostMsg 


Returns WORD f Success ; Success indicator 


WinDdeRespond 

EXTRN WinDdeRespond: FAR 

INCL_WINDDE equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndClient ; Client's window handle 

PUSH DWORD hwndServer ; Server's window handle 

PUSH@ ASCI IZ szAppName ; Application name 

PUSHO ASCIIZ szTopicName ;Topic name 

CALL WinDdeRespond 

Returns DWORD mresReply ; Message return data 


WinDefAVioWindowProc 

EXTRN WinDefAVioWindowProc: FAR 
INCL.AVIO equ 1 ;0r use INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD usMsgid ;Me$$age identity 

PUSH DWORD mpParaml ; Parameter 1 

PUSH DWORD mpParam2 ; Parameter 2 

CALL WinDefAVioWindowProc 

Returns DWORD mresreply ; Message return data 


WinDefDIgProc 

EXTRN WinDefDIgProc: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDlg ;Dialog-window handle 

PUSH WORD usMsgid ; Message identity 

PUSH DWORD mpParaml ; Parameter 1 

PUSH DWORD mpParam2 ; Parameter 2 

CALL WinDefDIgProc 

Returns DWORD mresReply ;Message-return data 


WinDefWindowProc 

EXTRN WinDefWindowProc: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 
PUSH WORD usMsgid ;Message identity 
PUSH DWORD mpParaml ; Parameter 1 
PUSH DWORD mpParam2 ; Parameter 2 
CALL WinDefWindowProc 

Returns DWORD mresReply ;Message-return data 
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WinDeleteAtom 

EXTRN WinDeleteAtom: FAR 

INCL_WINATOM equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hatomtblAtomTbl ; Atom- table handle 

PUSH WORD atom ;Atom identifying the atom to be deleted 

CALL WinDeleteAtom 

Returns WORD ReturnCode ; Return code 

WinDeleteLibrary 

EXTRN WinDeleteLibrary: FAR 

INCL_WINLOAD equ 1 ;0r use INCLJIIN or INCLJW 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hi ibLibhandle ; Library handle to be deleted 

CALL WinDeleteLibrary 

Returns WORD fDeleted ; Library -deleted indicator 

WinDeleteProcedure 

EXTRN WinDeleteProcedure: FAR 

INCL_WINLOAD equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSHO OTHER wndproc ; Window procedure identifier to be deleted 

CALL WinDeleteProcedure 

Returns WORD f success ; Procedure-deleted indicator 


WinDestroyAccelTable 

EXTRN WinDestroyAccelTable: FAR 

INCL_WINACCELERATORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD haccel Accel ; Accelerator-table handle 

CALL WinDestroyAccelTable 

Returns WORD fSuccess ; Success indicator 


WinDestroyAtomTable 

EXTRN WinDestroyAtomTable: FAR 

INCLJaIINATOM equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hatomtblAtomTbl ;Atom-table handle 
CALL WinDestroyAtomTable 

Returns DWORD hatomtbl ReturnCode ; Return code 


W i n Destroy Cu rso r 

EXTRN WinDestroyCursoriFAR 

INCL_WINCURSORS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle to which the cursor belongs 

CALL WinDestroyCursor 

Returns WORD fSuccess ; Success indicator 


WinDestroyHeap 

EXTRN WinDestroyHeap: FAR 

INCL_WINHEAP equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hheapHeap ;Heap handle 
CALL WinDestroyHeap 

Returns DWORD hheapHeapRet ; Returned heap handle 
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WinDestroyMsgQueue 

EXTRN WinDestroyMsgQueue: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hmq ;Message-queue handle 

CALL WinDestroyMsgQueue 

Returns WORD f Destroyed ; Queue-destroyed indicator 


WinDestroyPointer 

EXTRN WinDestroyPointer: FAR 

I NCL_W IN POINTERS equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hptrPointer ; Handle of pointer to be destroyed 
CALL WinDestroyPointer 

Returns WORD f Success ; Success indicator 


WinDestroyWindow 

EXTRN WinDestroyWindow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 
CALL WinDestroyWindow 

Returns WORD f Success ; Window-destroyed indicator 


WinDismissDIg 

EXTRN WinDismissDIg: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL.PM. Also in COMMON section 

PUSH DWORD hwndDlg ; Dialog-window handle 

PUSH WORD usResult ; Reply value 

CALL WinDismissDIg 

Returns WORD f Success ; Dialog-dismissed indicator 


WinDispatchMsg 

EXTRN WinDispatchMsg: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 

PUSH© OTHER qmsgMsg ;Message structure 

CALL WinDispatchMsg 

Returns DWORD mresReply ; Message-return data 


WinDIgBox 

EXTRN WinDIgBox: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCLJrfIN or INCL_PM. Also in COMMON section 


PUSH 

DWORD 

hwndParent 

PUSH 

DWORD 

hwndOwner 

PUSH© 

OTHER 

DlgProc 

PUSH 

WORD 

Resource 

PUSH 

WORD 

usDlgid 

PUSH© 

OTHER 

CreateParams 

CALL WinDIgBox 



; Parent-window handle of the created dialog window 
Requested owner-window handle of the created dialog window 
; Dialog procedure for the created dialog window 
; Resource identity containing the dialog template 
;Dialog-template identity within the resource file 
; Application-defined data area 


Returns WORD usResult 


; Reply value 
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WinDrawBitmap 

EXTRN WinDrawBitmap: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hps ;Handle of presentation space in which the bit map is drawn 

PUSH DWORD hbm ; Bit-map handle 

PUSHO OTHER rclSrc ; Subrectangle of bit map to be drawn 

PUSHO OTHER ptlDest ; Bit-map destination 

PUSH DWORD IForeColor ; Foreground color 

PUSH DWORD IBackColor ; Background color 

PUSH WORD fsRgf ; Flags that determine how the bit map is drawn 

CALL WinDrawBitmap 

Returns WORD f Success ; Success indicator 

WinDrawBorder 

EXTRN WinDrawBorder: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH@ OTHER rcl Rectangle ; Bounding rectangle for the border 

PUSH WORD sVertSi deWidth ; Width of border rectangle vertical sides 

PUSH WORD sHorizSi deWidth ; Wi dth of border rectangle horizontal sides 

PUSH DWORD IBorderColor ; Col or of edge of border 

PUSH DWORD 1 InteriorColor ; Col or of interior of border 

PUSH WORD fsCmd ; Flags controlling the way in which the border is drawn 

CALL WinDrawBorder 

Returns WORD f Success -.Success indicator 

WinDrawPointer 

EXTRN WinDrawPointer: FAR 

INCL_WINPOINTERS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hps ; Presentation-space handle into which the pointer is drawn 

PUSH WORD sx ;X coordinate at which to draw the pointer, in device coordinates 

PUSH WORD sy ;Y coordinate at which to draw the pointer, in device coordinates 

PUSH DWORD hptrPointer ; Pointer handle 

PUSH WORD usHalftone ; Shading control 

CALL WinDrawPointer 

Returns WORD f Success ; Success indicator 


WinDrawText 

EXTRN WinDrawText: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCLWIN or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH WORD sCount ; Count of the number of characters in the string 

PUSHO OTHER chText ; Character string to be drawn 

PUSH@ OTHER rcl Rectangle ;Text rectangle 

PUSH DWORD IForeColor ; Foreground color 

PUSH DWORD IBackColor ; Background color 

PUSH WORD fsCmd ;An array of flags that determines how the text is drawn 

CALL WinDrawText 

Returns WORD sChars ; Count of characters drawn within the rectangle 
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WinEmptyClipbrd 

EXTRN WinEmptyClipbrd: FAR 

I NC L_WI NC LI PBOARD equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 
CALL WinEmptyClipbrd 

Returns WORD f Success ; Success indicator 


WinEnablePhysInput 

EXTRN WinEnablePhysInput: FAR 

INCLJrfININPUT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD fNewInputState ;New state for the queuing of physical input 

CALL WinEnablePhysInput 

Returns WORD fOldlnputState previous state for the queuing of physical input 


WinEnableWindow 

EXTRN WinEnableWindow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD fNewEnabled ;New enabled state 
CALL WinEnableWindow 

Returns WORD f Success ; Window enabled indicator 


WinEnableWindowllpdate 

EXTRN WinEnableWindowUpdate:FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD fNewVisibility ;New visibility state 
CALL WinEnableWindowUpdate 

Returns WORD f Success ;Visibility-changed indicator 


WinEndEnumWindows 

EXTRN Wi nEndEnumWi ndows : FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD henum ; Enumeration handle 
CALL WinEndEnumWindows 

Returns WORD f Success ; Success indicator 


WinEndPaint 

EXTRN WinEndPaint: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 
CALL WinEndPaint 

Returns WORD fSuccess ; Success indicator 


WinEnumClipbrdFmts 

EXTRN WinEnumCl ipbrdFmts:FAR 

INCL_WINCLIPBOARD equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usPrev previous clipboard-data format index 

CALL WinEnumClipbrdFmts 

Returns WORD usNext ;Next clipboard-data format index 
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WinEnumDIgltem 

EXTRN WinEnumDIgltem: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hwndDlg ;Dialog-window handle 

PUSH DWORD hwnd ; Chi Id-window handle 

PUSH WORD usCode ; Item-type code 

PUSH WORD fLock ;Lock indicator 

CALL WinEnumDIgltem 

Returns DWORD hwndltem ; Item-window handle 


WinEqualRect 

EXTRN WinEqualRect: FAR 

INCLJIINRECTANGLES equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER rcl Recti ; First rectangle 

PUSH© OTHER rclRect2 ; Second rectangle 
CALL WinEqualRect 

Returns WORD f Equal ; Equality indicator 


WinExcludellpdateRegion 

EXTRN Wi nExcl udeUpdateRegi on : FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCLWIN or INCL_PM 

PUSH DWORD hps ; Presentation-space handle whose clipping region is to be updated 

PUSH DWORD hwnd ; Window handle 

CALL Wi nExcl udeUpdateRegi on 

Returns WORD sComplexity ; Complexity value 


WinFillRect 

EXTRN WinFillRect: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Presentation-space handle 

PUSHO OTHER rclRect ; Rectangle to be filled, in window coordinates 

PUSH DWORD 1 Col or ; Col or with which to fill the rectangle 

CALL WinFillRect 

Returns WORD f Success ; Success indicator 


WinFindAtom 

EXTRN WinFindAtom: FAR 

INCL_WINATOM equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hatomtblAtomTbl ; Atom-table handle 
PUSHO ASCI IZ szAtomName ;Atom name 

CALL WinFindAtom 

Returns WORD atom ;Atom value 


WinFlashWindow 

EXTRN WinFlashWindow: FAR 

INCL_WINFRAMEMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hwnd ;Handle of window to be flashed 

PUSH WORD f FI ash ;Start-fl ashing indicator 

CALL WinFlashWindow 

Returns WORD f Success ;Success indicator 
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WinFocusChange 

EXTRN WinFocusChange: FAR 

INCL_WININPUT equ 1 ;0r use INCLWIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
PUSH DWORD hwndNewFocus ; Window handle to receive the focus 
PUSH WORD fsFocusChange ; Focus changing indicators 
CALL WinFocusChange 

Returns WORD f Success ; Success indicator 


WinFreeErrorlnfo 

EXTRN WinFreeErrorlnfoiFAR 

INCL_WINERRORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSHO OTHER erriErrorlnfo ; Error- information block whose memory is to be released 
CALL WinFreeErrorlnfo 

Returns WORD f Success ; Success indicator 


WinFreeMem 

EXTRN WinFreeMem: FAR 

INCL_WINHEAP equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hheapHeap ; Handle to a heap 

PUSH WORD npbMem ; Memory block to be freed 

PUSH WORD usLength ;Size of the memory to be freed 

CALL WinFreeMem 


Returns WORD npbReturn ; Values as follows 


WinGetClipPS 

EXTRN WinGetClipPS: FAR 

INCLJ/INWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ;Handle of window for which the presentation space is required 

PUSH DWORD hwndCl i pWi ndow ;Handle of window for clipping 

PUSH WORD usClipflags ; Clipping control flags 

CALL WinGetClipPS 

Returns DWORD hps ; Presentation-space handle that can be used for drawing 


WinGetCurrentTime 

EXTRN WinGetCurrentTime: FAR 

INCL_WINTIMER equ 1 ;0r use INCL_WIN or INCL__PM 

PUSH DWORD hab ; Anchor-block handle 
CALL WinGetCurrentTime 

Returns DWORD ulTime ;System-timer count 


WinGetDIgMsg 

EXTRN WinGetDIgMsg: FAR 

I NCL_W INDIA LOGS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDlg ;Dialog-window handle 

PUSHO OTHER qmsgmsg ;Message structure 

CALL WinGetDIgMsg 


Returns WORD fResult Continue message indicator 
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WinGetErrorlnfo 

EXTRN WinGetErrorlnfo: FAR 

I NCL_WIN ERRORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

CALL WinGetErrorlnfo 

Returns 00THER erri Errorlnfo ;Error information 


WinGetKeyState 

EXTRN WinGetKeyState: FAR 

INCL_WININPUT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle: 
PUSH WORD sVk ; Virtual key value 

CALL WinGetKeyState 

Returns WORD sKeyState ;Key state 


WinGetLastError 

EXTRN WinGetLastError: FAR 

INCL_WINERRORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

CALL WinGetLastError 

Returns DWORD erridErrorCode ; Last-error state 


WinGetMinPosition 

EXTRN WinGetMinPosition: FAR 

INCL_WINFRAMEMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hwnd ; Frame-window handle 

PUSHO OTHER Swp ;Set window position structure 

PUSH@ OTHER ptl Point preferred position 
CALL WinGetMinPosition 

Returns WORD f Success ; Success indicator 


WinGetMsg 

EXTRN WinGetMsg: FAR 

INCL_WINME$SAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 


PUSH 

DWORD 

hab 

PUSH@ 

OTHER 

qmsgmsg 

PUSH 

DWORD 

hwndFil ter 

PUSH 

WORD 

usFirst 

PUSH 

WORD 

usLast 

CALL WinGetMsg 



;Anchor-block handle 
;Message structure 
;Window filter 
;First message identity 
;Last message identity 


Returns WORD f Result 


;Continue message indicator 


WinGetNextWindow 

EXTRN WinGetNextWindow: FAR 

INCL.WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD henum ; Enumeration handle 
CALL WinGetNextWindow 

Returns DWORD hwndNext ;Next window handle in enumeration list 
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WinGetPhysKeyState 

EXTRN WinGetPhysKeyState: FAR 

INCL_WININPUT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
PUSH WORD sScancode ; Hardware scancode 
CALL WinGetPhysKeyState 

Returns WORD sKeyState ;Key state 

WinGetPS 

EXTRN WinGetPS: FAR 

I NC L_WI NWI NDOWMGR equ 1 ;Or use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Handle of window for which the presentation space is required 
CALL WinGetPS 

Returns DWORD hps ; Presentation-space handle that can be used for drawing in the window 

WinGetScreenPS 

EXTRN WinGetScreenPS: FAR 

I NCL_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

CALL WinGetScreenPS 

Returns DWORD hpsScreenPS ; Presentation-space handle 

WinGetSysBitmap 

EXTRN WinGetSysBitmap: FAR 

INCL_WINPOINTERS equ 1 ;0r use INCL_WIN or INCLJ>M 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD i Index ; System bit-map index value 

CALL WinGetSysBitmap 

Returns DWORD hbm ; System bit-map handle 

WinlnflateRect 

EXTRN WinlnflateRect: FAR 

INCL_WINRECT ANGLES equ 1 ;0r use INCLJrfIN or INCLJ>M 

PUSH DWORD hab ; Anchor-block handle 

PUSH@ OTHER rclrect ; Rectangle to be expanded 

PUSH WORD sex ; Horizontal expansion 

PUSH WORD scy ; Vertical expansion 

CALL WinlnflateRect 

Returns WORD f Success ; Success indicator 

Winlnitialize 

EXTRN Winlnitialize: FAR 

I NCL_WI NWI NDOWMGR equ 1 ;Or use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH WORD fsOptions ; Initial ization options 
CALL Winlnitialize 

Returns DWORD hab ; Anchor-block handle 
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WinlnSendMsg 

EXTRN WinlnSendMsg: FAR 

INCLJJINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

CALL WinlnSendMsg 

Returns WORD f Processing ;Message-processing indicator 


WinlnstStartApp 

EXTRN WinlnstStartApp: FAR 

INCLJIINWINDOWMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hini ; Initialization-file handle 

PUSH DWORD hwndNotify Window ; Notification-window handle 

PUSH WORD cCount ; Count of elements in the Application parameter. Must be 1 or 

2 

PUSHO ASCIIZ aszAppli cation ; Identifier of the application to be started 

PUSHO ASCIIZ szCmdLine ; Input parameters for the application to be started 

PUSHO OTHER Data ; Start data 

PUSH WORD fsOptions ;0ption indicators 

CALL WinlnstStartApp 

Returns DWORD happ ;Appli cation handle 


WinlntersectRect 

EXTRN WinlntersectRect: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER rclDest ; Intersection rectangle 

PUSH@ OTHER rcl Recti ; First rectangle 

PUSH© OTHER rclRect2 ; Second rectangle 

CALL WinlntersectRect 

Returns WORD f Success ; Success indicator 


WinlnvalidateRect 

EXTRN WinlnvalidateRect: FAR 

INC L_W I NW I NDOWMG R equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window whose update region is to be changed 

PUSH@ OTHER rclPrc ; Update rectangle 

PUSH WORD flncludeClippedChildren ;Inval idati on-scope indicator 

CALL WinlnvalidateRect 

Returns WORD f Success ; Success indicator 


WinlnvalidateRegion 

EXTRN WinlnvalidateRegion: FAR 

INCLJrfINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window whose update region is to be changed 

PUSH DWORD hrgn ; Handle of the region to be added to the window's 

update region 

PUSH WORD flncludeClippedChildren ; Inval idati on-scope indicator 
CALL WinlnvalidateRegion 

Returns WORD f Success ; Success indicator 
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WinlnvertRect 

EXTRN WinlnvertRect: FAR 

INC L_W I NW I NDOWMGR equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER rclRect ; Rectangle to be inverted 
CALL WinlnvertRect 

Returns WORD fSuccess ; Success indicator 


WinlsChild 

EXTRN WinlsChild: FAR 

I NCL_WINWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndChild ; Chi ld-window handle 
PUSH DWORD hwndParent ; Parent-window handle 
CALL WinlsChild 

Returns WORD f Related ; Related indicator 


WinlsRectEmpty 

EXTRN WinlsRectEmpty: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER rclprc ; Rectangle 
CALL WinlsRectEmpty 

Returns WORD f Empty ; Empty indicator 


WinlsThreadActive 

EXTRN Wi nlsThreadActi ve: FAR 

INCL_WINWINDOWMGR equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle of calling thread 
CALL WinlsThreadActive 

Returns WORD f Active ;Active-window indicator 


WinlsWindow 

EXTRN WinlsWindow: FAR 

INCLJtfINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hwnd ;Window handle 

CALL WinlsWindow 

Returns WORD fValid ; Validity indicator 


WinlsWindowEnabled 

EXTRN WinlsWindowEnabled: FAR 

I NC L_WI NWI NDOWMGR equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hwnd ;Window handle 
CALL WinlsWindowEnabled 

Returns WORD f Enabled ; Enabled-state indicator 


WinlsWindowShowing 

EXTRN WinlsWindowShowing: FAR 

INCL_WINWINDOWMGR equ 1 ;Or use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 

CALL WinlsWindowShowing 

Returns WORD f Showing ; Showing state indicator 
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WinlsWindowVisible 

EXTRN WinlsWindowVisibleiFAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 
CALL WinlsWindowVisible 

Returns WORD fVisible ; Vi sibil ity-state indicator 


WinLoadAccelTable 

EXTRN WinLoadAccelTable: FAR 

INCL_WINACCELERATORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD Resource Resource identity containing the accelerator table 

PUSH WORD idAccel Table ; Accelerator- table identifier, within the resource file 

CALL WinLoadAccelTable 

Returns DWORD haccel Accel ;Accelerator-table handle 


WinLoadDIg 

EXTRN WinLoadDIg: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 


PUSH 

DWORD 

hwndParent 

PUSH 

DWORD 

hwndOwner 

PUSH® 

OTHER 

DlgProc 

PUSH 

WORD 

Resource 

PUSH 

WORD 

idDlgid 

PUSH® 

OTHER 

CreateParams 

CALL WinLoadDIg 


; Parent-window handle of the created dialog window 
Requested owner-window handle of the created dialog window 
; Dialog procedure for the created dialog window 
; Resource identity containing the dialog template 
;Dialog-template identity within the resource file 
;Appli cation-defined data area 


Returns DWORD hwndDl g 


; Dialog-window handle 


WinLoadLibrary 

EXTRN WinLoadLibrary: FAR 

INCL_WINLOAD equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCIIZ szLibname ; Library name 

CALL WinLoadLibrary 

Returns DWORD hlibLibhandle ; Library handle 


WinLoadMenu 

EXTRN WinLoadMenu: FAR 

INCLJIINMENUS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndOwner ; Owner- and parent-window handle 

PUSH WORD Resource ; Resource identifier 

PUSH WORD idMenuid ;Menu identifier within the resource file 

CALL WinLoadMenu 

Returns DWORD hwndMenu ;Menu-window handle 


WinLoadPointer 

EXTRN WinLoadPointer: FAR 

INCL_WINPOINTERS equ 1 ;0r use INCLJilIN or INCLJ>M 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD Resource Resource identity containing the pointer definition 

PUSH WORD idPointer identifier of the pointer to be loaded 

CALL WinLoadPointer 

Returns DWORD hptr ; Pointer handle 
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WinLoadProcedure 

EXTRN Wi nLoadProcedure : FAR 

INCL_WINLOAD equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hlibLibhandle ; Library handle 
PUSH® ASCI IZ szProcname procedure name 
CALL WinLoadProcedure 

Returns MOTHER Wndproc ;Window-procedure identifier 


WinLoadString 

EXTRN WinLoadString: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH 

DWORD 

hab 

PUSH 

WORD 

Resource 

PUSH 

WORD 

idString 

PUSH 

WORD 

sBufferMax 

PUSHO 

ASCIIZ 

szBuffer 

CALL WinLoadString 


; Anchor-block handle 

;Resource identity containing the string 
;String identifier 
;Size of buffer 

;Buffer that is to receive the string 


Returns WORD sLength ;The length of the string returned 


WinLockHeap 

EXTRN WinLockHeap:FAR 

INCL_WINHEAP equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hheapHeap ; Handle to a heap 
CALL WinLockHeap 

Returns MOTHER Start ; Segment containing the passed heap 


WinLockVisRegions 

EXTRN WinLockVisRegions: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle or HWND_DESKT0P 

PUSH WORD fLock ; Indicates whether the visible regions are being locked or 

unlocked 

CALL WinLockVisRegions 

Returns WORD f Success ; Success indicator 


WinLockWindow 

EXTRN WinLockWindow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 
PUSH WORD fLock ;Lock indicator 
CALL WinLockWindow 

Returns DWORD hwndRet ;Locked-window handle 


WinLockWindowUpdate 

EXTRN WinLockWindowUpdate: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ;Desktop handle of the screen containing the window to be locked 

PUSH DWORD hwndLockUpdate ; Handle of window in which output is to be prevented 

CALL WinLockWindowUpdate 

Returns WORD fSuccess ; Success indicator 
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WinMakePoints 

EXTRN WinMakePoints: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSHO OTHER wptppt ; Points to be converted 

PUSH WORD ccount ; Number of points to be converted 

CALL WinMakePoints 

Returns WORD f Success ; Success indicator 


WinMakeRect 

EXTRN WinMakeRect: FAR 

INCL_WINRECT ANGLES equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH0 OTHER wrcprc ; Rectangle to be converted 

CALL WinMakeRect 

Returns WORD f Success ; Success indicator 


WinMapDIgPoints 

EXTRN WinMapDIgPoints: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDIg ; Dialog-window handle 

PUSHO OTHER aptl Points ; Coordinate points to be mapped 

PUSH WORD usCount ; Number of coordinate points 

PUSH WORD f Opt ions Calculation control 

CALL WinMapDIgPoints 

Returns WORD f Success ;Coordinates-mapped indicator 


WinMapWindowPoints 

EXTRN WinMapWindowPoints CAR 

INCLWINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndFrom ; Handle of the window from whose coordinates points are to be 

mapped 

PUSH DWORD hwndTo ; Handle of the window to whose coordinates points are to be mapped 

PUSHO OTHER aptl Points ; Points to be mapped to the new coordinate system 

PUSH WORD sCount ; Number of points to be mapped 

CALL WinMapWindowPoints 

Returns WORD f Success ; Success indicator 


WinMessageBox 

EXTRN WinMessageBox: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCLJIIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndParent ; Parent-window handle of the created message-box window 

PUSH DWORD hwndOwner Requested owner-window handle of the created message-box window 

PUSHO ASCI IZ szText ;Message-box window message 

PUSH@ ASCI IZ szTitle ;Message-box window title 

PUSH WORD usWindow ; Message-box window identity 

PUSH WORD fsStyle ; Message-box window style 

CALL WinMessageBox 

Returns WORD usResponse ; User-response value 
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WinMsgMuxSemWait 

EXTRN WinMsgMuxSemWait: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH® WORD usIndexNbr ; Index of the cleared semaphore in the list 
PUSH® OTHER List ; Li st of semaphore descriptors 

PUSH DWORD dtTimeout ; Function time-out value 

CALL WinMsgMuxSemWait 

Returns WORD usrc ; Return code 


WinMsgSemWait 

EXTRN WinMsgSemWait: FAR 

INCL.WINMESSAGEMGR equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hsem ; Semaphore handle 

PUSH DWORD dtTimeout ; Function time-out value 
CALL WinMsgSemWait 

Returns WORD usrc ; Return code 


WinMultWindowFromIDs 

EXTRN WinMultWindowFromIDs: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD hwndParent 

PUSH® OTHER ahwnd 

PUSH WORD us First 

PUSH WORD us Last 

CALL WinMultWindowFromIDs 


; Parent-window handle 
; Window handles 

; First window identity value in the range (inclusive) 
;Last window identity value in the range (inclusive) 


Returns WORD sWi ndows 


; Number of window handles returned 


WinNextChar 

EXTRN WinNextChar: FAR 

INCL_WINCOUNTRY equ 1 ;0r use INCLJIIN or INCL PM 


PUSH DWORD 
PUSH WORD 
PUSH WORD 
PUSH® ASCIIZ 


hab ; Anchor-block handle 

usCodepage ;Code page 

usCountry ; Country code 

szCurrentChar ; Current character in a null -terminated string 


CALL WinNextChar 


Returns ®ASCIIZ szNextChar ;Next character in the null -terminated string 


WinOffsetRect 

EXTRN WinOffsetRect: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCL WIN or INCL PM 


PUSH 

DWORD 

hab 

; Anchor-block handle 

PUSH® 

OTHER 

rcl rect 

; Rectangle to be offset 

PUSH 

WORD 

sex 

;x value of offset 

PUSH 

WORD 

scy 

;y value of offset 

CALL WinOffsetRect 


Returns WORD 

fSuccess 

;Success indicator 


WinOpenClipbrd 

EXTRN WinOpenClipbrd: FAR 

INCL_WINCLIPBOARD equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

CALL WinOpenClipbrd 

Returns WORD fSuccess ; Success indicator 
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WinOpenWindowDC 

EXTRN WinOpenWindowDC: FAR 

I NCL_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL.PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 
CALL WinOpenWindowDC 

Returns DWORD hdc ; Device-context handle 


WinPeekMsg 

EXTRN WinPeekMsg: FAR 

INCLWINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER qmsgmsg ;Message structure 

PUSH DWORD hwndFilter ; Window filter 

PUSH WORD usFirst ; First message identity 

PUSH WORD usLast ;Last message identity 

PUSH WORD fsOptions ; Options 

CALL WinPeekMsg 

Returns WORD f Result ;Message-available indicator 


WinPostMsg 

EXTRN WinPostMsg: FAR 

INCL_WINMESSAGEMGR equ 1 ;Or use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ;Window handle 
PUSH WORD usMsgid ;Message identity 
PUSH DWORD mpParaml ; Parameter 1 
PUSH DWORD mpParam2 ; Parameter 2 
CALL WinPostMsg 

Returns WORD fResult ;Message-posted indicator 

WinPostQueueMsg 

EXTRN WinPostQueueMsg: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hmq ;Message-queue handle 
PUSH WORD usMsgid ;Message identifier 
PUSH DWORD mpParaml parameter 1 
PUSH DWORD mpParam2 ; Parameter 2 
CALL WinPostQueueMsg 

Returns WORD f Success ; Success indicator 


WinPrevChar 

EXTRN WinPrevChar: FAR 

INCL.WINCOUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usCodepage ;Code page 

PUSH WORD usCountry ; Country code 

PUSH® ASCIIZ szStart Character string that contains CurrentChar 

PUSH® ASCIIZ szCurrentChar ;Current character 

CALL WinPrevChar 

Returns ®ASCIIZ szPrevChar ; Previous character 
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WinProcessDIg 

EXTRN WinProcessDIg; FAR 

I NCL_W INDIA LOGS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDlg ; Dialog-window handle 
CALL WinProcessDIg 

Returns WORD usResult ; Reply value 


WinPtlnRect 

EXTRN WinPtlnRect: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH@ OTHER rclrect ; Rectangle to be queried 
PUSHO OTHER ptl point ; Point to be queried 
CALL WinPtlnRect 

Returns WORD f ; Success indicator 


WinQueryAccelTable 

EXTRN WinQueryAccelTable: FAR 

INCLJtfINACCELERATORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ;Anchor-bl ock handle 

PUSH DWORD hwndFrame ; Frame -window handle 
CALL WinQueryAccelTable 

Returns DWORD haccel Accel Accelerator- table handle 


WinQueryActiveWindow 

EXTRN WinQueryActiveWindow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndParent ; Parent-window handle for which the active window is required 

PUSH WORD fLock ; Windows lock-state indicator 

CALL WinQueryActiveWindow 

Returns DWORD hwndActive Active-window handle 


WinQueryAnchorBlock 

EXTRN WinQueryAnchorBlock: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 
CALL WinQueryAnchorBlock 

Returns DWORD hab Anchor block handle 


WinQueryAtomLength 

EXTRN Wi nQueryAtomLength : FAR 

INCLJdINATOM equ 1 ;0r use INCL_WIN or INCLJ>M 

PUSH DWORD hatomtblAtomTbl Atom-table handle 

PUSH WORD atom Atom whose associated character-string length is to be 

returned 

CALL Wi nQueryAtomLength 


Returns WORD usretlen ; String length 
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WinQueryAtomName 

EXTRN WinQueryAtomName: FAR 

INCL_WINATQM equ 1 ;0r use INCLJUN or INCL_PM 


PUSH DWORD hatomtblAtomTbl 

PUSH WORD atom 

PUSHO ASCI IZ szBuffer 

PUSH WORD usBufferMax 

CALL WinQueryAtomName 


; Atom-table handle 

;Atom; identifies the character string to be retrieved 
; Buffer to receive the character string 
; Buffer size in bytes 


Returns WORD usretlen ; Length of retrieved character string 


WinQueryAtomLIsage 

EXTRN WinQueryAtomUsage:FAR 

INCL_WINATOM equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hatomtblAtomTbl ;Atom-table handle 

PUSH WORD atom ;Atom whose use count is to be returned 

CALL WinQueryAtomUsage 

Returns WORD uscount ;U$e count of the atom 


WinQueryCapture 

EXTRN WinQueryCapture: FAR 

INCLJIININPUT equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hwndDesktop ; Desktop- window handle 
PUSH WORD fLock ; Lock-request indicator 

CALL WinQueryCapture 

Returns DWORD hwnd ; Handle of the window with the pointer captured 


WinQueryClassInfo 

EXTRN WinQueryClassInfo: FAR 

INCLJ/INWINDQWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH0 ASCIIZ szClassName ; Cl ass name 
PUSH@ OTHER clsiClassInfo ;Class information structure 
CALL WinQueryClassInfo 

Returns WORD fExists ;Class-exists indicator 


WinQueryClassName 

EXTRN WinQueryClassName: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ;Window handle 

PUSH WORD sLength ; Length of Buffer 

PUSH0 OTHER chBuffer ;Class name 

CALL WinQueryClassName 

Returns WORD sRetLen Returned class name length 


WinQueryClipbrdData 

EXTRN WinQueryClipbrdData: FAR 

I NCL_W INCLIPBOARD equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usfmt ; Format of the data to be accessed 

CALL WinQueryClipbrdData 

Returns DWORD ulData ;Handle to the clipboard data 
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WinQueryClipbrdFmtlnfo 

EXTRN WinQueryClipbrdFmtlnfo: FAR 

INCL_WINCLIPBOARD equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usfmt ; Format of the data to be queried 

PUSH0 WORD usFmtlnfo ;Memory model and usage flags 

CALL WinQueryClipbrdFmtlnfo 

Returns WORD f Exists ;Format-exists indicator 


WinQueryClipbrdOwner 

EXTRN WinQueryClipbrdOwner: FAR 

I NCL_W INCLIPBOARD equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD fLock ;Lock state indicator of clipboard owner window 

CALL Wi nQueryCl i pbrdOwner 

Returns DWORD hwndCl i pbrdOwner ; Window handle of the current clipboard owner 


WinQueryClipbrdViewer 

EXTRN WinQueryClipbrdViewer: FAR 

INCL_WINCLIPBOARD equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD fLock ; Lock-state indicator of clipboard viewer window 

CALL WinQueryClipbrdViewer 

Returns DWORD hwndCl ipbrdViewer ; Current clipboard viewer window handle 


WinQueryCp 

EXTRN WinQueryCp: FAR 

INCL_WINCOUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hmq ;Message queue 

CALL WinQueryCp 

Returns WORD usCodePage ;Code page 


WinQueryCpList 

EXTRN WinQueryCpList: FAR 

INCL_WINCOUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD uscount ; Maxi mum number of code pages returned 

PUSHO OTHER ausCodepage ;Code page list 

CALL WinQueryCpList 

Returns WORD usTotCount ;Total number of code pages available 


WinQueryCursorlnfo 

EXTRN WinQueryCursorlnfo: FAR 

INCLJfINCURSORS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSHO OTHER csriCursorlnfo ; Cursor information 

CALL WinQueryCursorlnfo 

Returns WORD f Cursor ; Current-cursor indicator 
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WinQueryDefinition 

EXTRN WinQueryDefinition: FAR 

INCLJIINPRQGRAMLIST equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 
PUSH WORD 


hab 

hprogProgHandl e 

pibProgramlnfo 

usMaxLength 


CALL WinQueryDefinition 
Returns WORD us Length 


; Anchor-block handle 

; Handle of the program whose information is to be returned 
; Program-information data 
; Maxi mum length in bytes 

; Length of returned data 


WinQueryDesktopWindow 

EXTRN WinQueryDesktopWindow: FAR 

INC L_W I N W I NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hdc ; Device-context handle 

CALL WinQueryDesktopWindow 

Returns DWORD hwndDeskTop ; Desktop-window handle 


WinQueryDIgltemShort 

EXTRN WinQueryDIgltemShort: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 


PUSH DWORD hwndDlg ; Parent-window handle 

PUSH WORD idltem ; Identity of the child window whose text is to be converted 

PUSH® WORD sResult ; Integer value resulting from the conversion 

PUSH WORD fSigned ;Sign indicator 

CALL WinQueryDIgltemShort 


Returns WORD f Success ;Success indicator 


WinQueryDIgltemText 

EXTRN WinQueryDIgltemText: FAR 

INCLJ/INDIALOGS equ 1 ;0r use INCL_WIN or INCLJW. Also in COMMON section 

PUSH DWORD hwndDlg ; Parent-window handle 

PUSH WORD idltem identity of the child window whose text is to be queried 

PUSH WORD sMaxText ; Length of Text 

PUSH® ASCIIZ szText ;0utput string 

CALL WinQueryDIgltemText 

Returns WORD usRetLen ;Actual number of characters returned 


WinQueryDIgltemTextLength 

EXTRN Wi nQueryDl gltemText Length : FAR 

INCL_WINDIALOGS equ 1 ;0r use INCLJtfIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDlg ; Parent-window handle 

PUSH WORD idltem identity of the child window whose text is to be queried 
CALL WinQueryDIgltemTextLength 

Returns WORD sRetLen ; Length of text 


WinQueryFocus 

EXTRN Wi nQueryFocus : FAR 

INCL_WININPUT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD fLock ;Window lock state indicator 

CALL WinQueryFocus 

Returns DWORD hwndFocus ; Focus-handle 
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WinQueryMsgPos 

EXTRN WinQueryMsgPos: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH© OTHER ptlptrpos ; Pointer position in screen coordinates 

CALL WinQueryMsgPos 

Returns WORD f Success ; Success indicator 


WinQueryMsgTime 

EXTRN Wi nQueryMsgTime : FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

CALL WinQueryMsgTime 

Returns DWORD ulTime ;Time in milliseconds 


WinQueryObjectWindow 

EXTRN WinQueryObjectWindow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
CALL WinQueryObjectWindow 

Returns DWORD hwndObject ;Object-window handle 


WinQueryPointer 

EXTRN WinQueryPointer: FAR 

INCL_WINPOINTERS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
CALL WinQueryPointer 

Returns DWORD hptrPointer ; Pointer handle 


WinQueryPointerlnfo 

EXTRN WinQueryPointerlnfo: FAR 

INCL_WINPOINTER$ equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hptr ; Pointer handle 

PUSH© OTHER ptriPointerlnfo ;Pointer-information structure 

CALL WinQueryPointerlnfo 

Returns WORD fSuccess ; Success indicator 


WinQueryPointerPos 

EXTRN WinQueryPointerPos: FAR 

INCL_WINPOINTERS equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH© OTHER ptl Point ; Pointer position in screen coordinates 

CALL WinQueryPointerPos 


Returns WORD fSuccess 


; Pointer position returned indicator 
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WinQueryPresParam 

EXTRN WinQueryPresParam: FAR 

INCL_WINSYS equ 1 ;0r use INCL_WIN or INCLJM 


PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH® DWORD 
PUSH DWORD 
PUSH® OTHER 
PUSH WORD 


hwnd 

idAttrTypel 

idAttrType2 

idAttrTypeFound 

cbAttrValueLen 

AttrValue 

fsOptions 


CALL WinQueryPresParam 


; Window handle 

; First attribute type identity 

; Second attribute type identity 

; Attribute type identity found 

;Byte count of the size of the AttrValue parameter 

; Attribute value 

;Options 


Returns DWORD cbRetLen ; Length of presentation parameter value passed back 


WinQueryProfileData 

EXTRN WinQueryProfileData: FAR 

INCL_WINSHELLDATA equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCI IZ szAppName ;Appli cation name 
PUSH® ASCI IZ szKeyName ;Key name 

PUSH® OTHER Value ; Value data 

PUSH® WORD usSize ;$ize of value data 
CALL WinQueryProfileData 

Returns WORD f Success ; Success indicator 


WinQueryProfilelnt 

EXTRN WinQueryProfilelnt: FAR 

INCLWINSHELLDATA equ 1 ;0r use INCL.WIN or INCL_PM 


PUSH DWORD hab 
PUSH® ASCI IZ szAppName 
PUSH® ASCI IZ szKeyName 
PUSH WORD sDefault 
CALL WinQueryProfilelnt 


; Anchor-block handle 
Application name 
;Key name 
; Default value 


Returns WORD sRequiredlnteger ;Key value specified in the intialization file 


WinQueryProfileSize 

EXTRN WinQueryProfileSize: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab Anchor-block handle 

PUSH® ASCIIZ szAppName Application name 
PUSH® ASCIIZ szKeyName ;Key name 

PUSH® WORD usValue ;Data length 

CALL WinQueryProfileSize 

Returns WORD usRetCode ; Success indicator 
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WinQueryProfileString 

EXTRN WinQueryProfileString: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD hab ; Anchor-block handle 

PUSH© ASCI IZ szAppName Application name 
PUSH© ASCIIZ szKeyName ;Key name 
PUSH© ASCIIZ szDefault ; Default string 
PUSH© OTHER Profilestring ;Profile string 
PUSH WORD usMaxPstring ;Maximum number 
CALL WinQueryProfileString 


Returns WORD usPstring Actual number 


WinQueryProgramTitles 

EXTRN WinQueryProgramTitles: FAR 

INCL_WINPROGRAMLIST equ 1 ;0r use INCL_WIN or INCL.PM 


PUSH DWORD 
PUSH DWORD 
PUSH© OTHER 
PUSH WORD 
PUSH© WORD 


hab Anchor-block handle 

hprogGroup ; Handle of the program group whose information is to be returned 

aprogeBuffer ; Program information buffer 

usBufferLen ; Buffer length 

usTotal ;Total number of structures 


CALL WinQueryProgramTitles 


Returns WORD f Success ; Success indicator 


WinQueryQueuelnfo 

EXTRN WinQueryQueuelnfo: FAR 

I NC L_WI NMESSAGEMGR equ 1 ;0r use INCLWIN or INCL_PM. Also in COMMON section 

PUSH DWORD hmq ; Queue handle 

PUSH© OTHER mqiMqinfo ;Message queue information structure to contain the queue informa- 
tion 

PUSH WORD cbCopied ;Size of message queue information structure that is provided (in 

bytes) 

CALL WinQueryQueuelnfo 

Returns WORD fSuccess ;Success indicator 


WinQueryQueueStatus 

EXTRN WinQueryQueueStatus: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
CALL WinQueryQueueStatus 

Returns DWORD fl Status ; Status information 


WinQuerySwitchEntry 

EXTRN WinQuerySwitchEntry: FAR 

INCL_WINSWITCHLIST equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hswitchSwitch ; Handle to the task list entry 

PUSH© OTHER swctlSwitchData ; Switch control data 

CALL WinQuerySwitchEntry 

Returns WORD usRetCode ; Return code 
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WinQuerySwitchHandle 

EXTRN WinQuerySwitchHandle: FAR 

INCLJIINSWITCHLIST equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ;Window handle of an application 

PUSH WORD idProcess ; Process identity of the application 

CALL WinQuerySwitchHandle 

Returns DWORD hswitchSwitch ; Switch list handle for the specified application 


WinQuerySwitchList 

EXTRN WinQuerySwitchList: FAR 

INCL_WINSWITCHLIST equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH© OTHER swblkSwitchEntries ; Switch entries block 

PUSH WORD usDataLength ;Maximum length of data returnable in bytes 

CALL WinQuerySwitchList 

Returns WORD usCount ;Total number of switch list entries present in the system 


WinQuerySysColor 

EXTRN WinQuerySysColor: FAR 

INCL_WINSYS equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
PUSH DWORD 1 Col or ; System color-index value 

PUSH DWORD 1 Reserved ; Reserved 
CALL WinQuerySysColor 

Returns DWORD IRgbColor ;RGB value 


WinQuerySysModalWindow 

EXTRN Wi nQuerySysModal Wi ndow: FAR 
I NC L_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD fLock ; Window's lock-state indicator 

CALL Wi nQuerySysModal Wi ndow 

Returns DWORD hwndSysModal ; Handle of system modal window 


WinQuerySysPointer 

EXTRN WinQuerySysPointer: FAR 

I NCL_WINP0 INTERS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD sldentifier ; System-pointer identifier 

PUSH WORD fCopy ;Copy indicator 

CALL WinQuerySysPointer 

Returns DWORD hptrPointer ; Pointer handle 


WinQuerySystemAtomTable 

EXTRN WinQuerySystemAtomTable: FAR 
INCL_WINATOM equ 1 ;0r use INCL_WIN or INCL_PM 

CALL WinQuerySystemAtomTable 

Returns DWORD hatomtblAtomTbl ; System atom-table handle 
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WinQuerySysValue 

EXTRN WinQuerySysValue: FAR 

INCL_WINSYS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
PUSH WORD sValueid ; System-value identity 

CALL WinQuerySysValue 

Returns DWORD 1 Value ;System value 


WinQueryTaskSizePos 

EXTRN WinQueryTaskSizePos: FAR 

INCL_WINSWITCHLIST equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usScreenGroup ; Screen group 

PUSH® OTHER swpPositionData ;Window position and size data 

CALL WinQueryTaskSizePos 

Returns WORD usRetCode ; Return code 


WinQueryTaskTitle 

EXTRN Wi nQueryT as kTi 1 1 e : FAR 

INCL_WINSWITCHLIST equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH WORD usSession ; Session identity of application whose title is requested 
PUSH® ASCIIZ szTitle ;Task title 

PUSH WORD usTitlelen ;Maximum length of data returnable in bytes 
CALL WinQueryTaskTitle 

Returns WORD usRetCode ; Return code 


WinQueryllpdateRect 

EXTRN WinQueryUpdateRect:FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window whose update rectangle is to be queried 

PUSH® OTHER rclPrc ; Update region that bounds the rectangle (in window coordinates) 

CALL WinQueryUpdateRect 

Returns WORD fSuccess ; Success indicator 


WinQueryUpdateRegion 

EXTRN WinQueryUpdateRegion: FAR 

I NC L_WI NWI NDOWMGR equ 1 ;0r use INCLWIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window whose update region is to be queried 

PUSH DWORD hrgn ; Handle of the window's update region 

CALL WinQueryUpdateRegion 

Returns WORD sComplexity Complexity of resulting region/error indicator 


WinQueryVersion 

EXTRN WinQueryVersion: FAR 

INC L_W I NW I NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 
CALL WinQueryVersion 

Returns DWORD flSysInf ;System information within which the application is operating 
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WinQueryWindow 

EXTRN Wi nQueryWi ndow: FAR 

INCL_WINWIND0WMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window to query 

PUSH WORD sCode ;Type of window information 

PUSH WORD fLock ;Lock control 

CALL WinQueryWindow 

Returns DWORD hwndRelated ; Window handle 


WinQueryWindowDC 

EXTRN WinQueryWindowDC: FAR 

I NC L_WI N WI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ;Window handle 
CALL WinQueryWindowDC 

Returns DWORD hdc ; Device-context handle 


WinQueryWindowLockCount 

EXTRN Wi nQueryWi ndowLockCount : FAR 
I NC L_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCLJ>M 

PUSH DWORD hwnd ; Window handle 
CALL WinQueryWindowLockCount 

Returns WORD sLock ;Window-lock count 


WinQueryWindowPos 

EXTRN Wi nQueryWi ndowPos : FAR 

INCL_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH® OTHER swp ; SWP structure 

CALL WinQueryWindowPos 

Returns WORD f Success ; Success indicator 

WinQueryWindowProcess 

EXTRN WinQueryWindowProcess: FAR 

INC L_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hwnd ; Window handle 

PUSH® WORD i dpi d ; Process identity of the thread that created the window 
PUSH® WORD idtid ;Thread identity of the thread that created the window 

CALL WinQueryWindowProcess 

Returns WORD fSuccess ; Success indicator 


WinQueryWindowPtr 

EXTRN WinQueryWindowPtr: FAR 

I NCL_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ;Window handle 
PUSH WORD sb ; Index 

CALL WinQueryWindowPtr 

Returns ®0THER p ; Pointer value 
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WinQueryWindowRect 

EXTRN WinQueryWindowRect: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL.WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ;Window handle 

PUSHO OTHER rclRect ; Window rectangle 

CALL WinQueryWindowRect 

Returns WORD f Success ; Rectangle-returned indicator 


WinQueryWindowText 

EXTRN WinQueryWindowText: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCLJIIN or INCL.PM 

PUSH DWORD hwnd ;Window handle 

PUSH WORD sLength ; Length 

PUSH@ OTHER chBuffer ; Window text 

CALL WinQueryWindowText 

Returns WORD sRetLen ; Length of returned text 


WinQueryWindowTextLength 

EXTRN Wi nQueryWi ndowT ext Length : FAR 
INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ;Window handle 
CALL WinQueryWindowTextLength 

Returns WORD sRetLen ; Length of the window text 


WinQueryWindowULong 

EXTRN Wi nQueryWi ndowULong : FAR 

INCLJrfINWINDOWMGR equ 1 ;0r use INCLJrfIN or INCL_PM 

PUSH DWORD hwnd ;Handle of window to be queried 

PUSH WORD sb ; Index 

CALL WinQueryWindowULong 

Returns DWORD ul Value ; Value contained in the window word 


WinQueryWindowUShort 

EXTRN WinQueryWindowUShort: FAR 

I NCL_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hwnd ;Handle of window to be queried 

PUSH WORD sb ; Index 

CALL WinQueryWindowUShort 

Returns WORD usValue ; Value contained in the indicated window word 


WinReallocMem 


EXTRN WinReallocMem: FAR 


INCL_WINHEAP 

equ 1 ;Or use INCL_WIN or INCL.PM 

PUSH DWORD 

hHeap 

; Handle to a heap 

PUSH WORD 

npbMemObj 

; Memory object 

PUSH WORD 

usOld 

;01d size 

PUSH WORD 

usNew 

;New size 

CALL WinReallocMem 


Returns WORD 

npbMem 

; Pointer to memory block 
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WinRegisterClass 

EXTRN WinRegisterClass: FAR 

I NC L_WI NWI NDOWMGR equ 1 ;0r use INCLJIIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ;Anchor-block handle 

PUSH® ASCIIZ szClassName ;Window-class name 

PUSH® OTHER WndProc ; Window-procedure identifier 

PUSH DWORD flClassStyle ; Default-window style 

PUSH WORD usExtra Reserved storage 

CALL WinRegisterClass 

Returns WORD f Registered ;Window-cl ass-registration indicator 


WinRegisterllserDatatype 

EXTRN Wi nRegi sterUserDatatype : FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 


PUSH DWORD hab ; Anchor-block handle 

PUSH WORD sDatatype ;Data type code to be defined 

PUSH WORD sCount ; Number of elements 

PUSH® OTHER asTypes ;Data type codes of structure components 

CALL Wi nRegi sterUserDatatype 


Returns WORD f Success ; Success indicator 


WinRegisterUserMsg 

EXTRN WinRegisterUserMsg: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 


PUSH 

DWORD 

hab 

PUSH 

WORD 

usMsgid 

PUSH 

WORD 

sTypel 

PUSH 

WORD 

sDirl 

PUSH 

WORD 

sType2 

PUSH 

WORD 

$Dir2 

PUSH 

WORD 

sTyper 

CALL WinRegisterUserMsg 


; Anchor-block handle 
;Message identifier 
; Datatype of message-parameter 1 
;Di recti on of message-parameter 1 
;Datatype of message-parameter 2 
;Di recti on of message-parameter 2 
;Datatype of message reply 


Returns WORD f Success ; Success indicator 


WinRegisterWindowDestroy 

EXTRN Wi nRegi sterWi ndowDestroy : FAR 
INCL_WINWINDOWMGR equ 1 ;0r use INCLWIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD f Register Registration indicator 

CALL WinRegisterWindowDestroy 

Returns WORD fSuccess ;Success indicator 


WinReleaseHook 

EXTRN WinReleaseHook: FAR 

INCL_WINHOOKS equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH 

DWORD 

hab 

PUSH 

DWORD 

hmq 

PUSH 

WORD 

sHook 

PUSH® 

OTHER 

Address 

PUSH 

WORD 

Modul e 

CALL WinReleaseHook 


; Anchor-block handle 

Randle of message queue from which the hook is to be released 
;Type of hook chain 
; Address of the hook routine 
;Module handle 


Returns WORD fSuccess ; Success indicator 
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WinReleasePS 

EXTRN WinReleasePS: FAR 

INCL.WINWINDOWMGR equ 1 ;Or use INCL.WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hps ; Handle of the cache presentation space to release 
CALL WinReleasePS 

Returns WORD f Success ; Success indicator 


WinRemovePresParam 

EXTRN WinRemovePresParam: FAR 

INCL_WINSYS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH DWORD idAttrType ;Attribute type identity 

CALL WinRemovePresParam 

Returns WORD f Success ; Success indicator 


WinRemoveSwitchEntry 

EXTRN WinRemoveSwitchEntry: FAR 

INCL_WINSWITCHLIST equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hswitchSwitch ;Switch-list (task-list) entry handle 
CALL Wi nRemoveSwi tchEntry 

Returns WORD usRetCode ; Success indicator 


WinScrollWindow 

EXTRN WinScrollWindow: FAR 

INCLJu/INWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 


PUSH 

DWORD 

hwnd 

;Window handle 

PUSH 

WORD 

sDx 

; Amount of horizontal scroll to the right (in device units) 

PUSH 

WORD 

sDy 

;Amount of vertical scroll upward (in device units) 

PUSHO 

OTHER 

rcl Scroll 

; Scroll rectangle 

PUSHO 

OTHER 

rclClip 

;C1 ip rectangle 

PUSH 

DWORD 

hrgnUpdateRgn 

; Update region 

PUSH@ 

OTHER 

rcl Update 

; Update rectangle 

PUSH 

WORD 

fsOptions 

; Scroll options 

CALL WinScrollWindow 


Returns WORD 

sComplexity 

; Complexity of resulting region/error indicator 


WinSendDIgltemMsg 

EXTRN WinSendDIgltemMsg: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL WIN or INCL PM 


PUSH DWORD hwndDlg 

PUSH WORD idltem 

PUSH WORD usMsgid 

PUSH DWORD mpParaml 

PUSH DWORD mpParam2 

CALL WinSendDIgltemMsg 


; Parent-window handle 
identity of the child window 
;Message identity 
;Message parameter 1 
;Message parameter 2 


Returns DWORD mresReply ;Message-return data 
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WinSendMsg 

EXTRN WinSendMsg: FAR 

INCL_WINME$$AGEMGR equ 1 ;0r use INCL.WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 
PUSH WORD usMsgid ;Message identity 
PUSH DWORD mpParaml ; Parameter 1 
PUSH DWORD mpParam2 ; Parameter 2 
CALL WinSendMsg 

Returns DWORD mresReply ;Message-return data 


WinSetAccelTable 

EXTRN WinSetAccelTable: FAR 

INCL_WINACCELERATORS equ 1 ;Or use INCLWIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD haccel Accel ; Accel erator-table handle 

PUSH DWORD hwndFrame ; Frame-wi ndow handle 

CALL WinSetAccelTable 

Returns WORD f Success ; Success indicator 


WinSetActiveWindow 

EXTRN WinSetActiveWindow: FAR 

INCLJIINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDeskTop ; Desktop-window handle 
PUSH DWORD hwnd ; Window handle 

CALL WinSetActiveWindow 

Returns WORD f Success ;Active-window-set indicator 


WinSetCapture 

EXTRN Wi nSetCapture : FAR 

INCL_WININPUT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDesktop ; Desktop-window handle, or HWND_DESKTOP 

PUSH DWORD hwnd ;Handle of the window that is to receive all pointing device mes- 

sages 

CALL WinSetCapture 

Returns WORD f Success ; Success indicator 


WinSetClassMsglnterest 

EXTRN WinSetClassMsglnterest: FAR 

I NC L_W I NMES S AGEMGR equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH0 ASCIIZ szClassName ;Window-class name 

PUSH WORD usMsgClass ;Message class to have interest level set 
PUSH WORD sControl ; Interest identifier for the message class 

CALL WinSetClassMsglnterest 

Returns WORD fSuccess ; Interest-changed indicator 


Chapter 9. Window Function Calls 9-37 



WinSetClipbrdData 

EXTRN WinSetClipbrdData: FAR 

INCLWINCLIPBOARD equ 1 ;Or use INCL.WIN or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD ulh ; Handle 

PUSH WORD usfmt ; Format 

PUSH WORD fsFmtlnfo ; Information 

CALL WinSetClipbrdData 

Returns WORD fDataPlaced ;Data-placed indicator 


WinSetClipbrdOwner 

EXTRN WinSetCl ipbrdOwner:FAR 

I NCL_W INCLIPBOARD equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hwnd ;Window handle of the new clipboard owner 

CALL Wi nSetCl i pbrdOwner 

Returns WORD fSuccess ; Success indicator 


WinSetClipbrdViewer 

EXTRN WinSetClipbrdViewer: FAR 

INCLWINCLIPBOARD equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hwndNewClipViewer ;Window handle of the new clipboard viewer 

CALL WinSetClipbrdViewer 

Returns WORD fSuccess ; Success indicator 


WinSetCp 

EXTRN WinSetCp: FAR 

INCL_WINCOUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hmq ;Message-queue handle 

PUSH WORD usCodePage ;Code page 

CALL WinSetCp 

Returns WORD fSuccess ; Success indicator 


WinSetDIgltemShort 

EXTRN WinSetDIgltemShort: FAR 

INCL_WINDIALOG$ equ 1 ;0r use INCL.WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDlg ; Parent-window handle 

PUSH WORD idltem ; Identity of the child window whose text is to be changed 

PUSH WORD usValue ; Integer value used to generate the dialog item text 

PUSH WORD f Signed ;Sign indicator 

CALL WinSetDIgltemShort 

Returns WORD fSuccess ; Success indicator 


WinSetDIgltemText 

EXTRN WinSetDIgltemText: FAR 

INCL_WINDIALOGS equ 1 ;Or use INCLJ/IN or INCL_PM. Also in COMMON section 
PUSH DWORD hwndDlg ; Parent-window handle 

PUSH WORD idltem ; Identity of the child window whose text is to be set 

PUSH@ ASCI IZ szText ; Source string 

CALL WinSetDIgltemText 

Returns WORD fSuccess ; Success indicator 
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WinSetErrorlnfo 

EXTRN WinSetErrorlnfo: FAR 

PUSH DWORD erridldError ; Error identity to be set 

PUSH WORD fsOptions ; Opt ions 

PUSH WORD usargs ; Parameter words 

CALL WinSetErrorlnfo 


WinSetFocus 

EXTRN WinSetFocus: FAR 

INCL_WININPUT equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH DWORD hwndNewFocus ; Window handle to receive the focus 

CALL WinSetFocus 

Returns WORD f Success ; Success indicator 


WinSetHook 

EXTRN WinSetHook: FAR 

INCLJrfINHOOKS equ 1 ;0r use INCLJJIN or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH WORD 
PUSHO OTHER 
PUSH WORD 
CALL WinSetHook 


hab ; Anchor-block handle 

hmq ; Queue identity 

sHookType ;Hook chain type 

HookProc ; Address of the application hook procedure 
Module ; Resource identity 


Returns WORD f Success ; Success indicator 


WinSetKeyboardStateTable 

EXTRN Wi nSetKeyboardStateTabl e : FAR 
INCL_WININPUT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH@ OTHER abKeyStateTable ;Key state table 
PUSH WORD fSet ;Set indicator 

CALL WinSetKeyboardStateTable 

Returns WORD f Success ; Success indicator 


WinSetMsglnterest 

EXTRN WinSetMsglnterest: FAR 

I NCL_WI NMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD usMsgClass ;Message class to have interest level set 

PUSH WORD sControl ; Interest-identifier for the message class 

CALL WinSetMsglnterest 

Returns WORD f Success ; Interest-changed indicator 


WinSetMsgMode 

EXTRN WinSetMsgMode: FAR 

INCL.WINMESSAGEMGR equ 1 ;0r use INCLWIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor block handle 

PUSHO ASCIIZ szClassName ; Window class name 

PUSH WORD sControl ;Message mode identifier 

CALL WinSetMsgMode 

Returns WORD fSuccess ;Message delay indicator 
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WinSetMultWindowPos 

EXTRN WinSetMultWindowPos: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH@ OTHER aSwp ; Array 

PUSH WORD cCount ; Window count 

CALL WinSetMultWindowPos 

Returns WORD fSuccess ; Positioning success indicator 


WinSetOwner 

EXTRN WinSetOwner: FAR 

INC L_WI NW I NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle whose owner window is to be changed 

PUSH DWORD hwndNewOwner ;Handle of the new owner 

CALL WinSetOwner 

Returns WORD fSuccess ; Success indicator 


WinSetParent 

EXTRN WinSetParent: FAR 

I NCLJi/INWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH DWORD hwndNewParent ;New parent window handle 

PUSH WORD f Redraw ; Redraw indicator 

CALL WinSetParent 

Returns WORD fSuccess ; Parent-changed indicator 


WinSetPointer 

EXTRN WinSetPointer: FAR 

INCL_WINPOINTERS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH DWORD hptrNewPointer ;New pointer handle 
CALL WinSetPointer 

Returns WORD fSuccess ; Pointer-updated indicator 


WinSetPointerPos 

EXTRN WinSetPointerPos: FAR 

INCLJtfINPOINTERS equ 1 ;0r use INCLJIIN or INCL_PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD sx ;x position of pointer in screen coordinates 

PUSH WORD sy ;y position of pointer in screen coordinates 

CALL WinSetPointerPos 


Returns WORD fSuccess ; Pointer position updated indicator 


WinSetPresParam 

EXTRN WinSetPresParam: FAR 

INCLJIINSYS equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH@ OTHER 


hwnd 

idAttrType 
cbAttrValueLen 
AttrVal ue 


CALL WinSetPresParam 


;Window handle 
; Attribute type identity 

;Byte count of the data passed in the AttrVal ue parameter 
; Attribute value 


Returns WORD fSuccess ; Success indicator 
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WinSetRect 

EXTRN WinSetRect: FAR 

INCL_WINRECTANGLES equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH 

DWORD 

hab 

PUSH0 

OTHER 

rcl rect 

PUSH 

WORD 

sLeft 

PUSH 

WORD 

s Bottom 

PUSH 

WORD 

sRight 

PUSH 

WORD 

sTop 

CALL WinSetRect 


; Anchor-block handle 
; Rectangle to be updated 
;left edge of rectangle 
; Bottom edge of rectangle 
; Right edge of rectangle 
;Top edge of rectangle 


Returns WORD fSuccess ; Success indicator 


WinSetRectEmpty 

EXTRN Wi nSetRect Empty : FAR 

INCLJtfINRECTANGLES equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSHO OTHER rclrect ; Rectangle to be set empty 

CALL WinSetRectEmpty 

Returns WORD fSuccess ; Success indicator 


WinSetSynchroMode 

EXTRN Wi nSetSynchroMode : FAR 

INCLJIINMESSAGEMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD sMode ; Synchronization mode 
CALL WinSetSynchroMode 

Returns WORD fSuccess ; Success indicator 


WinSetSysColors 

EXTRN WinSetSysColors: FAR 

INCL_WINSYS equ 1 ;0r use INCL_WIN or INCL_PM 


PUSH 

DWORD 

hwndDeskTop 

PUSH 

DWORD 

fl Opt ions 

PUSH 

DWORD 

ul Format 

PUSH 

DWORD 

1 Start 

PUSH 

DWORD 

ulTablen 

PUSH® 

OTHER 

alTable 

CALL WinSetSysColors 


; Desktop-window handle 
; Options 

;Format of entries in the table, as follows 
starting system color index 
; Number of elements 
;Table 


Returns WORD fSuccess ; Success indicator 


WinSetSysModalWindow 

EXTRN Wi nSetSysModal Wi ndow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL.PM 


PUSH DWORD hwndDesktop ; Desktop-window handle, or HWND_DE$KTOP 

PUSH DWORD hwnd ; Handle of window to become system-modal window 

CALL WinSetSysModalWindow 


Returns WORD fSuccess ; Success indicator 
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WinSetSysValue 

EXTRN WinSetSysValue: FAR 

INCL_WINSYS equ 1 ;0r use INCL^WIN or INCL.PM 

PUSH DWORD hwndDeskTop ; Desktop-window handle 

PUSH WORD sValueid ; System-value identity 

PUSH DWORD lvalue ; System value 

CALL WinSetSysValue 

Returns WORD f Success ; Value-set indicator 


WinSetWindowBits 

EXTRN WinSetWindowBits: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCLJtfIN or INCL_PM 


PUSH DWORD hwnd 

PUSH WORD sb 

PUSH DWORD fIData 

PUSH DWORD flMask 

CALL WinSetWindowBits 


;Window handle 

; Zero-based index of the value to be set 
;Bit data to store in the window words 
;Bits to be written indicator 


Returns WORD f Success ; Success indicator 


WinSetWindowPos 

EXTRN WinSetWindowPos: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL.WIN or INCLJ>M 


PUSH DWORD 
PUSH DWORD 
PUSH WORD 
PUSH WORD 
PUSH WORD 
PUSH WORD 
PUSH WORD 


hwnd ; Window handle 

hwndBehind ; Relative window-placement order 

sx ; Window position, x coordinate 

sy ; Window position, y coordinate 

sex ;Window size 

scy ; Window size 

fsOptions ;Window-positioning options 


CALL WinSetWindowPos 


Returns WORD f Success ; Repositioning indicator 


WinSetWindowPtr 

EXTRN WinSetWindowPtr: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD sb ;Zero-based index into the window words 

PUSH® OTHER p ; Pointer value to store in the window words 

CALL WinSetWindowPtr 

Returns WORD fSuccess ; Success indicator 


WinSetWindowText 

EXTRN Wi nSetWi ndowText : FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ;Window handle 
PUSH® ASCIIZ szString ;Window text 
CALL WinSetWindowText 

Returns WORD fResult ;Text-updated indicator 
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WinSetWindowULong 

EXTRN WinSetWindowULong: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCLJ/IN or INCL_PM 

PUSH DWORD hwnd ;Window handle 

PUSH WORD sb ;Zero-based index of the value to be set 

PUSH DWORD ulData Unsigned, long integer value to store in the window words 

CALL WinSetWindowULong 

Returns WORD fSuccess ;Success indicator 


WinSetWindowUShort 

EXTRN WinSetWindowUShort: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD sb ; Zero-based index of the value to be set 

PUSH WORD usData ; Unsigned, short integer value to store in the window words 

CALL WinSetWindowUShort 

Returns WORD fSuccess ; Success indicator 


WinShowCursor 

EXTRN WinShowCursor: FAR 

INC L_W INCURSORS equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Handle of window to which the cursor belongs 

PUSH WORD fShow ;Show indicator 

CALL WinShowCursor 

Returns WORD fSuccess ; Success indicator 


WinShowPointer 

EXTRN WinShowPointer: FAR 

I NCL_W IN POINTERS equ 1 ;0r use INCLWIN or INCL_PM 

PUSH DWORD hwndDeskTop ;Desktop-window handle 
PUSH WORD fShow ; Level -update indicator 

CALL WinShowPointer 

Returns WORD fSuccess ;Di splay-level -updated indicator 


WinShowT rackRect 

EXTRN Wi nShowT rackRect : FAR 

INCL_WINTRACKRECT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle 

PUSH WORD fShow ;Show indicator 
CALL WinShowTrackRect 

Returns WORD fSuccess ; Success indicator 


WinShowWindow 

EXTRN WinShowWindow: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM. Also in COMMON section 

PUSH DWORD hwnd ; Window handle 

PUSH WORD fNewVisibility ;New visibility state 
CALL WinShowWindow 

Returns WORD fSuccess Visibility changed indicator 
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WinStartTimer 

EXTRN WinStartTimer: FAR 

INCL_WINTIMER equ 1 ;0r use INCL_WIN or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hwnd ;Window handle that is part of the timer identification 

PUSH WORD idTimer ;Timer identifier 

PUSH WORD usTimeout ;Delay time in milliseconds 

CALL WinStartTimer 

Returns WORD usRet ; Return code 


WinStopTimer 

EXTRN WinStopTimer: FAR 

INCLWINTIMER equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH DWORD hwnd ; Window handle 

PUSH WORD usTimer ;Timer identifier 

CALL WinStopTimer 

Returns WORD f Success ; Success indicator 


WinSubclassWindow 

EXTRN WinSubclassWindow: FAR 

INCL.WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCLJ>M 

PUSH DWORD hwnd ;Handle of window that is being subclassed 

PUSH® OTHER NewWindowProc ;New window procedure 
CALL WinSubclassWindow 

Returns ®0THER OldWindowProc ;01d window procedure 


WinSubstituteStrings 

EXTRN WinSubstituteStrings: FAR 

INCL_WINDIALOGS equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window that processes the call 

PUSH® ASCIIZ szSrc ;Source string 

PUSH WORD sDestMax ;Maximum number of characters returnable 

PUSH® ASCIIZ szDest ; Resultant string 

CALL WinSubstituteStrings 

Returns WORD sDestRet ; Actual number of characters returned 


WinSubtractRect 

EXTRN Wi nSubtractRect : FAR 

INCL_WINRECTANGLES equ 1 ;0r use INOWIN or INCL_PM 

PUSH DWORD hab ;Anchor-block handle 

PUSH® OTHER rclDest ; Result 

PUSH® OTHER rclSrcl ; First source rectangle 

PUSH® OTHER rclSrc2 ; Second source rectangle 

CALL WinSubtractRect 

Returns WORD fNonempty ;Not-empty indicator 


WinTerminate 

EXTRN WinTerminate: FAR 

I NC L_WI N WI N DOWMGR equ 1 ;Or use INCLJIIN or INCL_PM. Also in COMMON section 

PUSH DWORD hab ; Anchor-block handle 

CALL WinTerminate 

Returns WORD fTerminated ;Termi nation indicator 
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WinTerminateApp 

EXTRN WinTerminateApp: FAR 

I NC L_WI N WI NDOWMGR equ 1 ;Or use INCL.WIN or INCL.PM 

PUSH DWORD happ ;Appli cation handle 
CALL WinTerminateApp 

Returns WORD f Success ; Success indicator 


WinThrow 

EXTRN WinThrow: FAR 

INCL.WINCATCHTHROW equ 1 ;Or use INCL_WIN or INCL_PM 

PUSH® OTHER ctchbfCatchBuf ; Saved execution-environment buffer 

PUSH WORD sThrowBack ;Return value 

CALL WinThrow 


WinTrackRect 

EXTRN WinTrackRect: FAR 

INCL_WINTRACKRECT equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Window handle where tracking is to take place 

PUSH DWORD hps ; Presentation-space handle 

PUSH® OTHER tiTrackinfo ;Track information 

CALL WinTrackRect 

Returns WORD f Success ; Success indicator 


WinTranslate Accel 

EXTRN WinTranslateAccel :FAR 

I NCL_WI NACCE LERATORS equ 1 ;0r use INCL WIN or INCL_PM 


PUSH DWORD 
PUSH DWORD 
PUSH DWORD 
PUSH® OTHER 


hab ; Anchor-block handle 

hwnd ; Destination window 

haccel Accel ; Accel erator-tabl e handl e 
Qmsg ;Message to be translated 


CALL WinTranslateAccel 


Returns WORD fSuccess ; Success indicator 


WinUnionRect 

EXTRN WinUnionRect: FAR 

INCL WINRECTANGLES equ 1 ;0r use INCL WIN or INCL PM 


PUSH DWORD hab 

PUSH® OTHER rclDest 

PUSH® OTHER rclSrcl 

PUSH® OTHER rclSrc2 

CALL WinUnionRect 


; Anchor-block handle 
; Bounding rectangle 
; First source rectangle 
; Second source rectangle 


Returns WORD f Nonempty ; Non-empty indicator 


WinUpdateWindow 

EXTRN WinUpdateWindow: FAR 

INCLJ/INWINDOWMGR equ 1 ;0r use INCL.WIN or INCLJM 

PUSH DWORD hwnd ;Window handle 
CALL WinUpdateWindow 

Returns WORD fSuccess ; Window-updated indicator 
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WinUpper 

EXTRN WinUpper: FAR 

INCLJi/INCOUNTRY equ 1 ;0r use INCLJrfIN or INCL.PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usCodepage ;Code page 

PUSH WORD usCountry ; Country code 

PUSH@ ASCIIZ szString ; String to be converted to uppercase 

CALL WinUpper 

Returns WORD usRetLen ; Length of converted string 


WinllpperChar 

EXTRN WinUpperChariFAR 

INCL_WINCQUNTRY equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usCodepage ;Code page 

PUSH WORD usCountry ; Country code 

PUSH WORD uslnchar ;Character to be translated to uppercase 

CALL WinUpperChar 

Returns WORD usOutchar ; Translated character 


WinValidateRect 

EXTRN WinValidateRect: FAR 

INCLJfINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwnd ; Handle of window whose update region is changed 

PUSHO OTHER rclRect ; Rectangle to be subtracted from the window's update 

region 

PUSH WORD flncludeClippedChildren ;Validation-scope indicator 
CALL WinValidateRect 

Returns WORD fSuccess ;Success indicator 


WinValidateRegion 

EXTRN WinValidateRegion: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCLJ>M 

PUSH DWORD hwnd ; Handle of window whose update region is changed 

PUSH DWORD hrgn ; Handle of subtracted region 

PUSH WORD flncludeClippedChildren ;Validat ion-scope indicator 

CALL WinValidateRegion 

Returns WORD fSuccess ; Success indicator 


WinWaitMsg 

EXTRN WinWaitMsg: FAR 

INCL_WINMESSAGEMGR equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD usFirst ; First message identity 

PUSH WORD usLast ;Last message identity 

CALL WinWaitMsg 

Returns WORD fSuccess ; Success indicator 
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WinWindowFromDC 

EXTRN WinWindowFromDC: FAR 

INC L_W I NW I NDOWMG R equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hdc ; Device-context handle 
CALL WinWindowFromDC 

Returns DWORD hwnd ; Window handle 


WinWindowFromID 

EXTRN WinWindowFromID: FAR 

INCL_WINWINDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndParent ; Parent-window handle 
PUSH WORD us identifier ; Identity of the child window 
CALL WinWindowFromID 

Returns DWORD hwnd ;Window handle 


WinWindowFromPoint 

EXTRN WinWindowFromPoint: FAR 

I NCL_WI NWI NDOWMGR equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hwndParent ; Window handle whose child windows are to be tested 

PUSHO OTHER ptl Point ;The point to be tested 

PUSH WORD fEnumChildren ;Test control 

PUSH WORD fLock ;Lock control 

CALL WinWindowFromPoint 

Returns DWORD hwndFound ;Window handle beneath Point 


WinWriteProfiieData 

EXTRN WinWriteProfiieData: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL_WIN or INCL_PM 

PUSH DWORD hab ; Anchor-block handle 

PUSH® ASCI IZ szAppName ;Text string 
PUSH® ASCI IZ szKeyName ;Text string 
PUSH© OTHER Value ; Value data 
PUSH WORD usSize ;Size of value data 
CALL WinWriteProfiieData 

Returns WORD f Success ; Success indicator 


WinWriteProfileString 

EXTRN WinWriteProfileString: FAR 

INCL_WINSHELLDATA equ 1 ;0r use INCL.WIN or INCL_PM 

PUSH DWORD hab ; Anchor block handle 

PUSHO ASCI IZ szAppName ;Text string 

PUSHO ASCI IZ szKeyName ;Text string 

PUSHO ASCI IZ szValue ;Text string 

CALL WinWriteProfileString 

Returns WORD f Success ; Success indicator 
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Chapter 10. Functions Supplied by Applications 


DialogProc 

EXTRN DialogProc: FAR 

PUSH DWORD hwnd ;Handle of the window to which the message applies 

PUSH WORD usmsg ;Message identity 

PUSH DWORD mpParaml ;Message parameter 1 

PUSH DWORD mpParam2 ;Message parameter 2 

CALL DialogProc 

Returns DWORD mresReply ;Message-return data 


WndProc 

EXTRN WndProc: FAR 

PUSH DWORD hwnd ;Window handle 

PUSH WORD usmsg ;Message identity 

PUSH DWORD mpParaml ;Message parameter 1 

PUSH DWORD mpParam2 ;Message parameter 2 

CALL WndProc 

Returns DWORD mresReply ;Message-return data 


CodePageChangeHook 

EXTRN CodePageChangeHook: FAR 

PUSH DWORD hmq ;Message-queue handle 

PUSH WORD usOl dCodePage ; Previous code page 

PUSH WORD usNewCodePage ;New code page 

CALL CodePageChangeHook 

HelpHook 

EXTRN HelpHook: FAR 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD sMode ;Help mode 

PUSH WORD sTopic ;Topic identifier 

PUSH WORD sSubTopic ; Subtopic identifier 

PUSH® OTHER rcl Position ; Rectangle 

CALL HelpHook 

Returns WORD f ; Indicator as to whether next hook in the chain is called 


InputHook 

EXTRN InputHook: FAR 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER Qmsg ;A QMSG data structure 

PUSH WORD fsOptions ;Message removal options 

CALL InputHook 

Returns WORD f Processed ; Processed indicator 
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JournalPlaybackHook 

EXTRN Journal PI aybackHook : FAR 

PUSH DWORD hab ; Anchor-block handle 

PUSH@ OTHER qmsg ;Data structure where the message to be played back is returned 
PUSH WORD fSkip ; Indicator as to whether the next message should be played back 
CALL JournalPlaybackHook 

Returns DWORD ITime ; Waiting time 


JournalRecordHook 

EXTRN Journal RecordHook : FAR 

PUSH DWORD hab ; Anchor-block handle 

PUSHO OTHER qmsg ;Data structure that contains the message to be recorded 

CALL JournalRecordHook 

Returns WORD fSuccess ;The return value from this hook is ignored 


LoaderHook 

EXTRN LoaderHook: FAR 

PUSH DWORD hab ; Anchor-block handle 

PUSH WORD sContext ; Origin of call to hook 

PUSH® ASCIIZ szlibname ; Library name 

PUSH@ DWORD hi ibLibhandle ; Library handle 


PUSH@ ASCIIZ szprocname 

PUSH@ OTHER wndproc 

PUSH@ WORD fSuccess 

CALL LoaderHook 

Returns WORD fProcessed 


MsgCtIHook 

EXTRN MsgCtIHook: FAR 

PUSH DWORD hab 

PUSH WORD sContext 

PUSH DWORD hwnd 

PUSHO ASCIIZ szClassName 
PUSH WORD usMsgClass 

PUSH WORD sControl 

PUSH@ WORD fSuccess 

CALL MsgCtIHook 

Returns WORD fProcessed 


; Procedure name 
; Window procedure identifier 
; Success indicator 

; Processing indicator 


; Anchor-block handle 
;0rigin of call to hook 
;Window handle 
;Window class name 
;Message class 
;Control setting 
;Success indicator 

processing indicator 


MsgFilterHook 

EXTRN MsgFilterHook PAR 

PUSH DWORD hab ;Anchor-block handle 

PUSH® OTHER Qmsg ;A queue message data structure 

PUSH WORD usContext ; Context in which the hook has been called 

CALL MsgFilterHook 

Returns WORD fProcessed processed indicator 
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RegisterUserMsg 


EXTRN RegisterUserMsg: FAR 


PUSH 

DWORD 

hab 

; Anchor-block handle 

PUSH 

WORD 

sContext 

;Origin of call to hook 

PUSH 

WORD 

usMsgid 

;Message identifier 

PUSH 

WORD 

sTypel 

;Data type of message-parameter 1 

PUSH 

WORD 

sDirl 

; Direction of message-parameter 1 

PUSH 

WORD 

sType2 

;Data type of message-parameter 2 

PUSH 

WORD 

sDir2 

; Direction of message-parameter 2 

PUSH 

WORD 

sTyper 

;Data type of message reply 

PUSH 

WORD 

sCount 

; Number of elements 

PUSH® 

OTHER 

asTypes 

;Data types of structure components 

PUSH® 

WORD 

fSuccess 

; Success indicator 

CALL RegisterUserMsg 


Returns WORD 

fProcessed 

; Processing indicator 


SendMsgHook 

EXTRN SendMsgHook: FAR 

PUSH DWORD hab ; Anchor-block handle 

PUSH® OTHER smhssmh ;Send message hook structure 
PUSH WORD flnterTask ;Intertask indicator 
CALL SendMsgHook 
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CREATEPARAMS 2-3 
CREATESTRUCT 2-4 
CTLDATA 2-4 
CURSORINFO 2-4 


D 

DDEINIT 2-4 
DDESTRUCT 2-4 
DevCIoseDC 3-1 
DevEscape 3-1 
DEVOPENDATA 2-4 
DevOpenDC 3-1 
DEVOPENSTRUC 2-5 
DevPostDeviceModes 3-1 
DevQueryCaps 3-2 
DevQueryDeviceNames 3-2 
DevQueryHardcopyCaps 3-2 
DialogProc 10-1 


DLGTEM PLATE 2-5 
DLGTITEM 2-5 
DRIVDATA 2-5 
DWORD data type 1-3 
dynamic linking 1-1 

E 

ENTRYFDATA 2-6 
ERRINFO 2-6 
ERRORID 2-6 


F 

FATTRS 2-6 
FFDESCS 2-6 
FIXED 2-6 
FONTMETRICS 2-7 
FRAMECDATA 2-8 
function call rules 1-2 
function calls 1-2 


G 

GpiAssociate 4-1 
GpiBeginArea 4-1 
GpiBeginElement 4-1 
GpiBeginPath 4-1 
GpiBitBIt 4-1 
GpiBox 4-2 

GpiCallSegmentMatrix 4-2 
GpiCharString 4-2 
GpiCharStringAt 4-2 
GpiCharStringPos 4-2 
GpiCharStringPosAt 4-3 
GpiCloseFigure 4-3 
GpiCioseSegment 4-3 
GpiCombineRegion 4-3 
GpiComment 4-3 
GpiConvert 4-4 
GpiCopyMetaFile 4-4 
GpiCorrelateChain 4-4 
GpiCorrelateFrom 4-4 
GpiCorrelateSegment 4-5 
GpiCreateBitmap 4-5 
GpiCreateLogColorTable 4-5 
GpiCreateLogFont 4-5 
GpiCreatePS 4-6 
GpiCreateRegion 4-6 
GpiDeleteBitmap 4-6 
GpiDeleteElement 4-6 
GpiDeleteElementRange 4-6 
GpiDeleteElementsBetweenLabels 4-6 
GpiDeleteMetaFile 4-7 
GpiDeleteSegment 4-7 
GpiDeleteSegments 4-7 
GpiDeleteSetld 4-7 
GpiDestroyPS 4-7 
GpiDestroyRegion 4-7 
GpiDrawChain 4-8 
GpiDrawDynamics 4-8 
GpiDrawFrom 4-8 


Index X-1 



GpiDrawSegment 4-8 
GpiElement 4-8 
GpiEndArea 4-8 
GpiEndElement 4-9 
GpiEndPath 4-9 
GpiEqualRegion 4-9 
GpiErase 4-9 
GpiErrorSegmentData 4-9 
GpiExcludeClipRectangle 4-9 
GpiFillPath 4-10 
GpiFullArc 4-10 
GpiGetData 4-10 
Gpiimage 4-10 

GpilntersectClipRectangle 4-10 
GpiLabel 4-11 
GpiLine 4-11 
GpiLoad Bitmap 4-11 
GpiLoadFonts 4-11 
GpiLoadMetaFile 4-11 
GpiMarker 4-11 
GpiModifyPath 4-12 
GpiMove 4-12 
GpiOffsetCHpRegion 4-12 
GpiOffsetElementPointer 4-12 
GpiOffsetRegion 4-12 
GpiOpenSegment 4-12 
GpiOutlinePath 4-13 
GpiPaintRegion 4-13 
GpiPartialArc 4-13 
GpiPlayMetaFile 4-13 
GpiPointArc 4-13 
GpiPolyFillet 4-14 
GpiPolyFilletSharp 4-14 
GpiPolyLine 4-14 
GpiPolyMarker 4-14 
GpiPolySpline 4-14 
GpiPop 4-14 
GpiPtlnRegion 4-15 
GpiPtVisible 4-15 
GpiPutData 4-15 
GpiQueryArcParams 4-15 
GpiQueryAttrMode 4-15 
GpiQueryAttrs 4-15 
GpiGueryBackColor 4-16 
GpiQueryBackMix 4-16 
GpiQueryBitmapBits 4-16 
GpiQueryBitmapDimension 4-16 
GpiGueryBitmapHandle 4-16 
GpiQueryBitmapParameters 4-16 
GpiQueryBoundaryData 4-17 
GpiQueryCharAngle 4-17 
GpiQueryCharBox 4-17 
GpiQueryCharDirection 4-17 
GpiQueryCharMode 4-17 
GpiQueryCharSet 4-17 
GpiQueryCharShear 4-17 
GpiQueryCharStringPos 4-18 
GpiQueryCharStringPosAt 4-18 
GpiQueryClipBox 4-18 
GpiQueryClipRegion 4-18 
GpiQueryColor 4-18 
GpiQueryColorData 4-19 
GpiQueryColorlndex 4-19 
GpiQueryCp 4-19 
GpIQueryCurrentPosition 4-19 
GptQueryDefArcParams 4-19 
GpiQueryDefAttrs 4-19 


GpiQueryDefauItViewMatrix 4-20 
GpiQueryDefCharBox 4-20 
GpiQueryDefTag 4-20 
GpiQueryDefViewingLimits 4-20 
GpiQueryDevice 4-20 
GpiQueryDeviceBitmapFormats 4-20 
GpiQueryDrawControl 4-21 
GpiQueryDrawingMode 4-21 
GpiQueryEditMode 4-21 
GpiQueryElement 4-21 
GpiQueryEiementPointer 4-21 
GpiQueryElementType 4-21 
GpiQueryFontFileDescriptions 4-22 
GpiQueryFontMetrics 4-22 
GpiQueryFonts 4-22 
GpiQueryGraphicsField 4-22 
GpiQuerylnitialSegmentAttrs 4-22 
GpiQueryKerningPairs 4-23 
GpiQueryLineEnd 4-23 
GpiQueryLineJoin 4-23 
GpiQueryLineType 4-23 
GpiQueryLineWidth 4-23 
GpiQueryLineWidthGeom 4-23 
GpiQueryLogColorTable 4-24 
GpiQueryMarker 4-24 
GpiQueryMarkerBox 4-24 
GpiQueryMarkerSet 4-24 
GpiQueryMetaFileBits 4-24 
GpiQueryMetaFileLength 4-24 
GpiQueryMix 4-25 
GpiQueryModelTransformMatrix 4-25 
GpiQueryNearestColor 4-25 
GpiGueryNumberSetlds 4-25 
GpiQueryPageViewport 4-25 
GpiQueryPattern 4-25 
GpiGueryPatternRefPoint 4-26 
GpiQueryPatternSet 4-26 
GpiQueryPel 4-26 
GpiQueryPickAperturePosition 4-26 
GpiQueryPickApertureSize 4-26 
GpiQueryPS 4-26 
GpiQueryRealColors 4-27 
GpiQueryRegionBox 4-27 
GpiQueryRegionRects 4-27 
GpiQueryRGBColor 4-27 
GpiQuerySegmentAttrs 4-27 
GpiQuerySegmentNames 4-28 
GpiQuerySegmentPriority 4-28 
GpiQuerySegmentTransformMatrix 4-28 
GpiQuerySetlds 4-28 
GpiQueryStopDraw 4-28 
GpiQueryTag 4-29 
GpiQueryTextBox 4-29 
GpiQueryViewingLimits 4-29 
GpiQueryViewingT ransformMatrix 4-29 
GpiQueryWidthTable 4-29 
GpiReaiizeColorTabte 4-29 
GpiRectlnRegion 4-30 
GpiRectVisible 4-30 
GpiRemoveDynamics 4-30 
GpiResetBoundaryData 4-30 
GpiResetPS 4-30 
GpiRestorePS 4-30 
G pi Rotate 4-31 
GpiSaveMetaFile 4-31 
GpiSavePS 4-31 
GpiScale 4-31 
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GpiSetArcParams 4-31 
GpiSetAttrMode 4-31 
GpiSetAttrs 4-32 
GpiSetBackColor 4-32 
GpiSetBackMix 4-32 
GpiSetBitmap 4-32 
GpiSetBitmapBits 4-32 
GpiSetBitmapDimension 4-32 
GpiSetBitmapId 4-33 
GpiSetCharAngle 4-33 
GpiSetCharBox 4-33 
GpiSetCharDirection 4-33 
GpiSetCharMode 4-33 
GpiSetCharSet 4-33 
GpiSetCharShear 4-34 
GpiSetClipPath 4-34 
GpiSetClipReglon 4-34 
GpiSetColor 4-34 
GpiSetCp 4-34 
GpiSetCurrentPosition 4-34 
GpiSetDefArcParams 4-35 
GpiSetDefAttrs 4-35 
GpiSetDefauItViewMatrix 4-35 
GpiSetDefTag 4-35 
GpiSetDefViewingLimits 4-35 
GpiSetDrawControl 4-35 
GpiSetDrawingMode 4-36 
GpiSetEditMode 4-36 
GpiSetElementPointer 4-36 
GpiSetElementPointerAtLabel 4-36 
GpiSetGraphicsField 4-36 
GpiSetlnitialSegmentAttrs 4-36 
GpiSetLineEnd 4-37 
GpiSetLineJoin 4-37 
GpiSetLineType 4-37 
GpiSetLineWidth 4-37 
GpiSetLineWidthGeom 4-37 
GpiSetMarker 4-37 
GpiSetMarkerBox 4-38 
GpiSetMarkerSet 4-38 
GpiSetMetaFileBits 4-38 
GpiSetMix 4-38 

GpiSetModelTransformMatrix 4-38 
GpiSetPageViewport 4-38 
GpiSetPattern 4-39 
GpiSetPatternRefPoint 4-39 
GpiSetPatternSet 4-39 
GpiSetPel 4-39 

GpiSetPickAperturePosition 4-39 
GpiSetPickApertureSize 4-39 
GpiSetPS 4-40 
GpiSetRegion 4-40 
GpiSetSegmentAttrs 4-40 
GpiSetSegmentPriority 4-40 
GpiSetSegmentTransformMatrix 4-40 
GpiSetStopDraw 4-41 
GpiSetTag 4-41 
GpiSetViewingLimits 4-41 
GpiSetViewingTransformMatrix 4-41 
GpiStrokePath 4-41 
GpiTranslate 4-41 
GpiUnloadFonts 4-42 
GpiUnrealizeColorTable 4-42 
GpiWCBitBIt 4-42 
GRADIENT 2-8 
GRADIENTL 2-8 


H 

HAB 2-8 
HACCEL 2-8 
HANDLE 2-8 
HAPP 2-8 
HATOMTBL 2-8 
HBITMAP 2-8 
HCINFO 2-8 
HDC 2-8 
HelpHook 10-1 
HENUM 2-8 
HHEAP 2-8 
HINI 2-8 
HUB 2-8 
HMF 2-8 
HMODULE 2-9 
HMQ 2-9 
HPOINTER 2-9 
HPROC 2-9 
HPROGARRAY 2-9 
HPROGRAM 2-9 
HPS 2-9 
HRGN 2-9 
HSEM 2-9 
HSPL 2-9 
HSWITCH 2-9 
HVPS 2-9 
HWND 2-9 


I 

IDENTITY 2-9 
IDENTITY4 2-9 
IMAGEBUNDLE 2-9 
INDEX2 2-9 
InputHook 10-1 
IPT 2-9 


J 

JournalPlaybackHook 10-2 
JournalRecordHook 10-2 


K 

kerning 2-9 
KERNINGPAIRS 2-9 

L 

LENGTH2 2-9 
LENGTH4 2-10 
LHANDLE 2-10 
LINEBUNDLE 2-10 
LoaderHook 10-2 
LONG 2-10 


M 

mapping metalanguage data types to MASM 1-3 
MARGSTRUCT 2-10 
MARKERBUNDLE 2-10 
MASM bindings 
header files 1-1 
MASM data types 
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MASM data types (continued) 

mapping from metalanguage data types 
MATRIX 2-10 
MATRIXLF 2-11 
MENUITEM 2-11 
metalanguage data types 

mapping to MASM data types 1-3 
MLECTLDATA 2-11 
MLE_SEARCHDATA 2-11 
MPARAM 2-12 
MQINFO 2-12 
MRESULT 2-12 
MsgCtIHook 10-2 
MsgFilterHook 10-2 
MT 2-12 
MTI 2-12 


N 

N PBYTE 2-12 


O 

OFFSET2B 2-12 
OVERFLOW 2-12 
OWNERITEM 2-13 


P 

PARAM 2-13 
PBYTE 2-13 
PCH 2-13 

PDEVOPENDATA 2-13 
PFN 2-13 
PFNWP 2-13 
PIBSTRUCT 2-13 
Piclchg 5-1 
PicPrint 5-1 
PID 2-14 
PIX 2-14 
POINT 2-14 
POINTERINFO 2-14 
POINTL 2-14 
POINTS 2-14 
PQMOPENDATA 2-14 
PRESDATA 2-14 
PRESPARAMS 2-14 
PrfAdd Prog ram 6-1 
PrfChangeProgram 6-1 
PrfCloseProfile 6-1 
PrfCreateGroup 6-1 
PrfDestroyGroup 6-1 
PrfOpenProfile 6-2 
PRFPROFILE 2-14 
PrfQueryDefinition 6-2 
PrfQueryProfile 6-2 
PrfQueryProfileData 6-2 
PrfQueryProfilelnt 6-2 
PrfQueryProfileSize 6-3 
PrfQueryProfileString 6-3 
PrfQueryProgramCategory 6-3 
PrfQueryProgramHandle 6-3 
PrfQueryProgramTitles 6-3 
PrfRemoveProgram 6-4 
PrfReset 6-4 
PrfWriteProfileData 6-4 


PrfWriteProfileString 6-4 
1-3 PROC 2-14 

PROGCATEGORY 2-14 
PROG DETAILS 2-15 
PROGRAMENTRY 2-15 
PROGTITLE 2-15 
PROGTYPE 2-15 
PROPERTY2 2-15 
PROPERTY4 2-15 
PSZ 2-15 

PUSH operation 1-2 
PUSH@ operation 1-2 
PVOID 2-15 


Q 

QMOPENDATA 2-15 
QMSG 2-16 


R 

RECT 2-16 
RECTL 2-16 
RegisterUserMsg 10-3 
RESID 2-16 
RGB 2-16 
RGNRECT 2-16 
ROF 2-16 
ROL 2-16 


S 

SBCDATA 2-17 
SEGOFF 2-17 
SendMsgHook 10-3 
SHORT 2-17 
SIZEF 2-17 
SIZEL 2-17 
SIZEROF 2-17 
SIZEROL 2-17 
SMHSTRUCT 2-17 
SpIQmAbort 7-1 
SplQmClose 7-1 
SplQmEndDoc 7-1 
SpIQmOpen 7-1 
SpIQmStartDoc 7-1 
SpIQmWrite 7-1 
SpIQpInstall 7-2 
SpIQpQueryDt 7-2 
standard data types 1-3 
STORAGE 2-17 
STR 2-17 
STRCOND 2-17 
STRL 2-18 
STRLLIST 2-18 
STR16 2-18 
STR32 2-18 
STR64 2-18 
STR8 2-18 
SWBLOCK 2-18 
SWCNTRL 2-18 
SWENTRY 2-18 
SWP 2-18 
SZ 2-18 
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T 

TID 2-10 
TIME 2-19 
TRACKINFO 2-19 


U 

UCHAR 2-19 
ULONG 2-19 
USERBUTTON 2-19 
USHORT 2-19 


V 

VioAssociate 8-1 
VioCreateLogFont 8-1 
VioCreatePS 8-1 
VioDeleteSetld 8-1 
Vio Destroy PS 8-1 
VioGetDeviceCellSize 8-2 
VioGetOrg 8-2 
VioQueryFonts 8-2 
VioQuerySetlds 8-2 
VioSetDeviceCellSize 8-2 
VioSetOrg 8-3 
VioShowPS 8-3 
VOID 2-19 


W 

WIDTH4 2-19 
WinAddAtom 9-1 
WinAddProgram 9-1 
WinAddSwitchEntry 9-1 
WinAlarm 9-1 
WioAllocMem 9-1 
WinAvailMem 9-2 
WinBeginEnumWindows 9-2 
WinBeglnPaint 9-2 
WinBroadcastMsg 9-2 
WinCalcFrameRect 9-2 
WinCallMsgFilter 9-2 
WinCancelShutdown 9-3 
WinCatch 9-3 
WinChangeSwitchEntry 9-3 
WinCloseClipbrd 9-3 
WinCompareStrlngs 9-3 
WinCopyAccelTable 9-3 
Win Copy Rect 9-4 
WinCpTranslateChar 9-4 
WinCpTranslateString 9-4 
WinCreateAccelTable 9-4 
WinCreateAtomTable 9-4 
WinCreateCursor 9-5 
WinCreateDIg 9-5 
WinCreateFrameControls 9-5 
WinCreateGroup 9-5 
WinCreateHeap 9-6 
WinCreateMenu 9-6 
WinCreateMsgQueue 9-6 
WinCreatePointer 9-6 
WinCreatePointerlndirect 9-6 
WinCreateStdWindow 9-7 
WinCreateSwitchEntry 9-7 
Win Create Window 9-7 


WinDdelnitiate 9-7 
WinDdePostMsg 9-8 
WinDdeRespond 9-8 
Wi n Def AVioWindowP roc 9-8 
WinDefDIgProc 9-8 
WinDefWindowProc 9-8 
WinDeleteAtom 9-9 
WinDeleteLibrary 9-9 
WinDeleteProcedure 9-9 
WinDestroyAccelTable 9-9 
WinDestroyAtomTable 9-9 
WinDestroyCursor 9-9 
WinDestroyHeap 9-9 
WinDestroyMsgQueue 9-10 
WinDestroyPointer 9-10 
WinDestroyWindow 9-10 
WinDismissDIg 9-10 
Win Dispatch Msg 9-10 
WinDIgBox 9-10 
WinDrawBitmap 9-11 
WinDrawBorder 9-11 
WinDrawPointer 9-11 
WinDrawText 9-11 
Win Empty Cl ipbrd 9-12 
WinEnablePhysInput 9-12 
WinEnableWindow 9-12 
WinEnableWindowllpdate 9-12 
WinEndEnumWindows 9-12 
WinEndPaint 9-12 
WinEnumClipbrdFmts 9-12 
WinEnumDIgltem 9-13 
WinEqualRect 9-13 
WinExcludellpdateRegion 9-13 
WinFillRect 9-13 
WinFindAtom 9-13 
WinFlashWindow 9-13 
WinFocusChange 9-14 
WinFreeErrorlnfo 9-14 
WinFreeMem 9-14 
WinGetClipPS 9-14 
WinGetCurrentTime 9-14 
WinGetDIgMsg 9-14 
WinGetErrorlnfo 9-15 
WinGetKeyState 9-15 
WinGetLastError 9-15 
WinGetMinPosition 9-15 
WinGetMsg 9-15 
WinGetNextWindow 9-15 
WinGetPhysKeyState 9-16 
WinGetPS 9-16 
WinGetScreenPS 9-16 
WinGetSysBitmap 9-16 
WinlnflateRect 9-16 
Winlnitialize 9-16 
WinlnSendMsg 9-17 
WlnlnstStartApp 9-17 
WinlntersectRect 9-17 
WinlnvalidateRect 9-17 
WinlnvaiidateRegion 9-17 
WinlnvertRect 9-18 
WinlsChild 9-18 
WinlsRectEmpty 9-18 
WinlsThreadActive 9-18 
WinlsWindow 9-18 
WinlsWindowEnabled 9-18 
WinlsWindowShowing 9-18 
WinlsWindowVisible 9-19 
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WinLoadAccelTable 9-19 
WinLoadDIg 9-19 
WinLoadLibrary 9-19 
WinLoadMenu 9-19 
WinLoadPointer 9-19 
WinLoadProcedure 9-20 
WinLoadString 9-20 
WinLocKHeap 9-20 
WinLockVisRegions 9-20 
WinLockWindow 9-20 
WinLockWindowUpdate 9-20 
WinMakePoints 9-21 
WinMakeRect 9-21 
WinMapDIgPoints 9-21 
WinMapWindowPoints 9-21 
WinMessageBox 9-21 
WinMsgMuxSemWait 9-22 
WinMsgSemWait 9-22 
WinMultWindowFromlDs 9-22 
WinNextChar 9-22 
WinOffsetRect 9-22 
WinOpenClipbrd 9-22 
WinOpenWindowDC 9-23 
WinPeekMsg 9-23 
WinPostMsg 9-23 
WinPostQueueMsg 9-23 
WinPrevChar 9-23 
WinProcessDIg 9-24 
WinPtlnRect 9-24 
WinQueryAccelTable 9-24 
WinQueryActiveWindow 9-24 
WinQueryAnchorBlock 9-24 
WinQueryAtomLength 9-24 
WinQueryAtomName 9-25 
WinQueryAtomUsage 9-25 
WinQueryCapture 9-25 
WinQueryClassInfo 9-25 
WinQueryClassName 9-25 
WinQueryClipbrdData 9-25 
WinQueryClipbrdFmtlnfo 9-26 
WinQueryClipbrdOwner 9-26 
WinQueryClipbrdViewer 9-26 
WinQueryCp 9-26 
WinQueryCpList 9-26 
WinQueryCursorlnfo 9-26 
WinQueryDefinition 9-27 
WinQueryDesktopWindow 9-27 
WinQueryDIgltemShort 9-27 
WinQueryDIgltemText 9-27 
WinQueryDIgltemTextLength 9-27 
WinQueryFocus 9-27 
WinQueryMsgPos 9-28 
WinQueryMsgTime 9-28 
WinQueryObjectWindow 9-28 
WinQueryPointer 9-28 
WinQueryPointerlnfo 9-28 
WinQueryPointerPos 9-28 
WinQueryPresParam 9-29 
WinQueryProfileData 9-29 
WinQueryProfilelnt 9-29 
WinQueryProfileSize 9-29 
WinQueryProfileString 9-30 
WinQueryProgramTitles 9-30 
WinQueryQueuelnfo 9-30 
WinQueryQueueStatus 9-30 
WinQuerySwitchEntry 9-30 
WinQuerySwitchHandle 9-31 


WinQueryS witch List 9-31 
WinQuerySysColor 9-31 
WinQuerySysModalWindow 9-31 
WinQuerySysPointer 9-31 
WinQuerySystemAtomTable 9-31 
WinQuerySysValue 9-32 
WinQueryTaskSizePos 9-32 
WinQueryTaskTitle 9-32 
WinQueryllpdateRect 9-32 
WinQueryUpdateRegion 9-32 
WinQueryVersion 9-32 
WinQueryWindow 9-33 
WinQueryWindowDC 9-33 
WinQueryWindowLockCount 9-33 
WinQueryWindowPos 9-33 
WinQueryWindowProcess 9-33 
WinQueryWindowPtr 9-33 
WinQueryWindowRect 9-34 
WinQueryWindowText 9-34 
WinQueryWindowTextLength 9-34 
WinQueryWindowllLong 9-34 
WinQueryWindowUShort 9-34 
WinReallocMem 9-34 
WinRegisterClass 9-35 
WinRegisterUserDatatype 9-35 
WinRegisterllserMsg 9-35 
WinRegisterWindowDestroy 9-35 
WinReleaseHook 9-35 
WinReleasePS 9-36 
WinRemovePresParam 9-36 
WinRemoveSwitch Entry 9-36 
WinScrollWindow 9-36 
WinSendDIgltemMsg 9-36 
WinSendMsg 9-37 
WinSetAccelTable 9-37 
W inSet Active Window 9-37 
WinSetCapture 9-37 
WinSetClassMsglnterest 9-37 
WinSetClipbrdData 9-38 
WinSetCiipbrdOwner 9-38 
WinSetCiipbrdViewer 9-38 
WinSetCp 9-38 
WinSetDIgltemShort 9-38 
WinSetDIgltemText 9-38 
WinSetErrorlnfo 9-39 
WinSetFocus 9-39 
WinSetHook 9-39 
WinSetKeyboardStateTable 9-39 
WinSetMsg Interest 9-39 
WinSetMsg Mode 9-39 
WinSet Mu ItWi ndowPos 9-40 
WinSetOwner 9-40 
WinSetParent 9-40 
WinSetPointer 9-40 
WinSetPointerPos 9-40 
WinSetPresParam 9-40 
WinSetRect 9-41 
WinSetRectEmpty 9-41 
WinSetSynchroMode 9-41 
WinSetSysColors 9-41 
WinSetSysModaiWindow 9-41 
WinSetSysValue 9-42 
WinSetWindowBits 9-42 
WinSetWindowPos 9-42 
WinSetWindowPtr 9-42 
WinSetWindowText 9-42 
WinSetWindowllLong 9-43 
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WinSetWindowUShort 9-43 
WinShowCursor 9-43 
WinShowPo inter 9-43 
WinShowTrackRect 9-43 
WinShowWindow 9-43 
WinStartTimer 9-44 
WinStopTimer 9-44 
WinSubclassWindow 9-44 
WinSubstituteStrings 9-44 
WinSubtractRect 9-44 
WinTerminate 9-44 
WinTerminateApp 9-45 
WinThrow 9-45 
WinTrackRect 9-45 
WinTrans late Accel 9-45 
WinllnionRect 9-45 
WinUpdateWindow 9-45 
WinUpper 9-46 
WinUpperChar 9-46 
WinValidateRect 9-46 
WinValidateRegion 9-46 
WinWaitMsg 9-46 
WinWindowFromDC 9-47 
WinWindowFromID 9-47 
WinWindowFromPoint 9-47 
WinWriteProfileData 9-47 
WinWriteProfileString 9-47 
WNDPARAMS 2-19 
WNDPROC 2-19, 10-1 
WORD data type 1-3 
WPOINT 2-20 
WRECT 2-20 


X 

XYWINSIZE 2-20 
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